TypeScript SDK 概览
先跑通 @therouter/sdk 的最小请求，再决定是否深入 Responses、Chat 或平台 API。
TypeScript SDK 适合已经在 Node.js、Next.js、Edge Runtime 或内部服务里调用模型的团队。 它的价值不是“换一种写法”，而是把认证、base URL、Responses / Chat / 平台接口统一在一个客户端里， 让后续接 BYOK、管理接口和导出时不必再改一套接入层。
安装
npm
npm install @therouter/sdk初始化
client.ts
import { TheRouter } from "@therouter/sdk";
export const client = new TheRouter({
apiKey: process.env.THEROUTER_API_KEY!,
baseURL: "https://api.therouter.ai/v1",
});| Name | Type | Required | Description |
|---|---|---|---|
apiKey | string | Required | 从 THEROUTER_API_KEY 读取的 key。首次接入阶段只要这一项就够了。 |
baseURL | string | 默认就是 https://api.therouter.ai/v1。只有在代理或自定义环境下才需要改。 | |
timeout | integer | 请求超时，单位毫秒。适合在后端服务里配合重试和熔断使用。 |
最小可用请求
Responses
const response = await client.responses.create({
model: "openai/gpt-4o-mini",
input: "把今天的 incident report 总结成 3 条 bullet。",
});
console.log(response.output_text);什么时候优先用 SDK
- 你已经在 Node.js 或 Edge 环境里写服务逻辑，而不是只打一条 cURL。
- 你想把 Responses、Chat 和后续平台接口放在同一客户端里。
- 你需要团队内保持 TypeScript / Python 的接口风格一致。
- 你想先把接入面稳定下来，再逐步加 BYOK、Skills 和治理。
环境变量
把 key 放在
THEROUTER_API_KEY，不要写死在源码里。第一次接入跑通之后， 再考虑管理 API key、BYOK 和更细的权限治理。