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);

核心参数

NameTypeRequiredDescription
model
stringRequired模型 ID,例如 anthropic/claude-sonnet-4.5。
messages
arrayRequired按顺序提供的对话消息。
stream
boolean设为 true 时返回流式 SSE 响应。
tools
array如果你要做原始工具调用,这里传 OpenAI-compatible tools。
什么时候该转去 Responses API
如果你已经开始重度使用 tools、structured outputs、reasoning 或多轮状态, Responses API 会比继续堆 chat 参数更清晰、更可解释。

下一步