Skip to main content

​
安装

环境要求： Node.js 18+（需要原生 fetch 支持）。可在 Node.js、Deno、Bun 以及边缘运行时中使用。

​
初始化

​
配置

请始终使用 www 主机。裸域名 https://hitheo.ai 会以 307 重定向到 https://www.hitheo.ai，而大多数 HTTP 客户端（包括 Node 18 内置的 fetch）在 3xx 响应上会剥离 Authorization 请求头——重定向后的请求将以未鉴权状态到达，并返回 401。自 @hitheo/sdk@0.2.0 起，SDK 已默认使用 https://www.hitheo.ai。如果你覆盖了 baseUrl，请参见401 故障排查。

​
包含内容

该 SDK 导出以下内容：

​
0.3.x 至 0.4.0 版本新增内容

@hitheo/sdk@0.4.0 新增了以编程方式进行的按密钥编排与账户管理能力——全部为增量特性，不会对现有的补全/流式代码造成破坏性变更：
  • theo.keys —— 通过代码创建密钥并配置其模型方案、编排器图与技能白名单。
  • theo.routingPreferences / theo.routingRules —— 编写并绑定关键词/正则路由规则。
  • theo.guardrails —— 管理网关护栏策略、预设及按密钥的绑定关系。
  • theo.billingCheckout / theo.billingPortal —— 充值额度并打开账单门户。
  • /v1/completions 请求新增了 memory: false 标志（跳过长期记忆注入），以及更丰富的单次请求字段——详见创建补全。

​
升级到 0.2.0

如果你正在从 0.1.x 升级：
  • 对于常规的 theo.complete() / theo.stream() 用法，无需修改代码。
  • 如果你曾显式固定 baseUrl: "https://hitheo.ai"，请将其移除（或改为 "https://www.hitheo.ai"），以启用新的默认值并避免请求头被重定向剥离。
  • theo.stream() 现在返回一个 TheoStream。for await 用法依然有效；此外你还可以使用 .cancel() 以及补全完成后的元数据（conversationId、usage、requestId）。
  • CompletionResponse.usage 现在包含 prompt_tokens、completion_tokens、total_tokens，以及一个可选的 cached 布尔值。原有的 res.usage.cost_cents 用法仍可正常使用。
  • 原先返回 Promise<unknown[]> 的列表方法（conversations、skills、tools、workflows、submissions 等）现在返回类型化记录——请移除任何 as any 类型断言。 完整发布说明：更新日志。