Skip to main content

使用 PHP SDK 运行

当你想从 PHP 调用提示词部署时,请使用官方的 fetch-hive/sdk Composer 包。SDK 使用符合 PHP 风格的外观包装了公共的 POST /v1/prompt/invoke 端点,处理身份验证,并将流式响应作为已解析事件数组的生成器公开。

安装

该 SDK 需要 PHP 8.1+,并使用 Guzzle 作为其 HTTP 客户端。

身份验证

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

基本示例

调用提示词部署并读取最终响应:
invokePrompt 会阻塞直到提示词完成,并将已解析的 JSON 主体作为关联数组返回。请参阅 非流式响应结构

方法参考

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

处理响应

流式响应

使用 invokePromptStream 在到达时接收 Server-Sent Events。该方法返回一个可使用 foreach 迭代的 Generator
该流会产生 调用提示词 → 响应 中记录的相同事件类型:reasoningresponse、最终的 usage 事件,或在提供商在流中失败时产生的 error 事件。

配置

错误

非 2xx 响应会抛出 FetchHive\Sdk\Exception\ApiException,其中包含状态码和响应体。如需处理失败,请捕获该异常:
有关状态码含义,请参阅 错误与速率限制

链接

后续步骤