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 類型斷言。 完整發布說明：更新日誌。