Chat API(TypeScript)导读
如果你的主要场景还是 chat completions,这页会先说明 client.chat 的核心边界。
TypeScript SDK 里的 client.chat 主要服务于仍然以 OpenAI-compatible Chat Completions 为核心的代码路径。它适合迁移成本要尽量低的团队,但如果你已经开始关心工具调用、 多轮上下文和统一输出语义,就应该开始看 Responses API。
可用方法
client.chat.completions.create():创建一次标准聊天补全请求。client.chat.completions.stream():以流式方式接收增量内容。client.chat.sessions.list():列出持久化的聊天 session。
最小示例
TypeScript
import { TheRouter } from "@therouter/sdk";
const client = new TheRouter({
apiKey: process.env.THEROUTER_API_KEY!,
});
const completion = await client.chat.completions.create({
model: "anthropic/claude-sonnet-4.5",
messages: [{ role: "user", content: "给我一份 launch checklist。" }],
});
console.log(completion.choices[0].message.content);核心参数
| Name | Type | Required | Description |
|---|---|---|---|
model | string | Required | 模型 ID,例如 anthropic/claude-sonnet-4.5。 |
messages | array | Required | 按顺序提供的对话消息。 |
stream | boolean | 设为 true 时返回流式 SSE 响应。 | |
tools | array | 如果你要做原始工具调用,这里传 OpenAI-compatible tools。 |
什么时候该转去 Responses API
如果你已经开始重度使用 tools、structured outputs、reasoning 或多轮状态, Responses API 会比继续堆 chat 参数更清晰、更可解释。