Skip to main content

使用 Python SDK 运行

当你想从 Python 调用提示词部署时,请使用官方的 fetch-hive-sdk 包。SDK 使用符合 Python 风格的辅助函数包装了公共的 POST /v1/prompt/invoke 端点,处理身份验证,并为你解析流式响应。

安装

SDK 需要 Python 3.9+,底层使用 httpx

身份验证

FETCH_HIVE_API_KEY 环境变量设置为你的工作区 API 密钥(SDK 会自动读取它):
或显式传入密钥:
有关如何创建和轮换密钥,请参阅 API 密钥

基本示例

调用提示词部署并读取最终响应:
invoke_prompt 是同步的,并在提示词完成后返回已解析的 JSON 主体。请参阅 非流式响应结构

方法参考

SDK 会为 invoke_prompt 注入 streaming: false。要使用流式,请使用下面的 invoke_prompt_stream

处理响应

非流式响应是一个普通的 dict

流式响应

使用 invoke_prompt_stream 在到达时接收 Server-Sent Events。该方法返回一个生成器,逐个产出已解析的事件字典:
该流会产生 调用提示词 → 响应 中记录的相同事件类型:reasoningresponse、最终的 usage 事件,或在提供商在流中失败时产生的 error 事件。

异步流式

对于 asyncio 应用,请使用 ainvoke_prompt_stream。它具有相同的参数,但返回异步迭代器:

配置

错误

非 2xx 响应会引发 httpx.HTTPStatusError,其中包含状态码和响应体。如需处理失败,请将调用包裹在 try/except 中:
有关状态码含义,请参阅 错误与速率限制

链接

后续步骤