Skip to main content

使用 Node.js SDK 运行

当你想从 Node.js 或 TypeScript 调用提示词部署时,请使用官方的 @fetch-hive/sdk 包。SDK 用类型化的客户端包装了公共的 POST /v1/prompt/invoke 端点,处理身份验证,并将流式响应作为 AsyncIterable 公开。

安装

该 SDK 针对 Node.js 18+(使用全局 fetch),并开箱即用地附带 TypeScript 类型定义。

身份验证

FETCH_HIVE_API_KEY 环境变量设置为你的工作区 API 密钥:
或显式传入密钥:
有关如何创建和轮换密钥,请参阅 API 密钥

基本示例

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

方法参考

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

处理响应

流式响应

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

配置

错误

非 2xx 响应会抛出一个 Error,其消息包含状态码和响应体:
有关状态码含义,请参阅 错误与速率限制

链接

后续步骤