快速开始
先用中文跑通第一次接入，再按你的场景进入对应英文详解页。
TheRouter.ai 提供统一的、兼容 OpenAI 的 API，让你通过单一端点访问多个 AI 模型。它会自动处理故障切换，并把请求路由到更合适的供应商。对大多数团队， 更高效的做法是先跑通第一次请求，再按需接入 BYOK、Skills 和更细的路由策略。
10 分钟接入步骤
使用 OpenAI SDK
最快的入门方式。使用官方 OpenAI SDK，改一个 base URL 就能验证你的 key、模型名和请求路径是否正常。
import OpenAI from 'openai';
const openai = new OpenAI({
baseURL: 'https://api.therouter.ai/v1',
apiKey: '<THEROUTER_API_KEY>',
});
async function main() {
const completion = await openai.chat.completions.create({
model: 'anthropic/claude-sonnet-4.5',
messages: [
{
role: 'user',
content: '生命的意义是什么？',
},
],
});
console.log(completion.choices[0].message);
}
main();直接使用 API
如果你想先排除 SDK 变量，直接打 API 最干净。能跑通这里，再去排 Cursor、Claude Code 或应用侧集成。
Base URL： https://api.therouter.ai/v1
curl https://api.therouter.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $THEROUTER_API_KEY" \
-d '{
"model": "anthropic/claude-sonnet-4.5",
"messages": [
{
"role": "user",
"content": "生命的意义是什么？"
}
]
}'流式输出
TheRouter.ai 支持通过 Server-Sent Events (SSE) 流式返回内容。在请求里加stream: true，就能边生成边接收 token。
import OpenAI from 'openai';
const openai = new OpenAI({
baseURL: 'https://api.therouter.ai/v1',
apiKey: '<THEROUTER_API_KEY>',
});
const stream = await openai.chat.completions.create({
model: 'anthropic/claude-sonnet-4.5',
messages: [{ role: 'user', content: '给我讲个故事' }],
stream: true,
});
for await (const chunk of stream) {
const content = chunk.choices[0]?.delta?.content || '';
process.stdout.write(content);
}模型命名
TheRouter.ai 使用标准的 供应商/模型名称 格式。先把模型名写对，再去配置更复杂的路由策略。
anthropic/claude-opus-4.6 # Claude Opus 4.6
anthropic/claude-sonnet-4.5 # Claude Sonnet 4.5
anthropic/claude-haiku-4.5 # Claude Haiku 4.5
openai/gpt-4o # GPT-4o
openai/gpt-4o-mini # GPT-4o Mini如果你想先确认价格、上下文长度和模型能力，请先去 中文模型页。
关键文档入口
下面这些是当前提供中文说明的主要技术入口。不是每一页都已经完整翻译，但每一页都对应明确的使用场景。
如果你在用 Cursor 或 Claude Code
中文入口如果你的主要工作流在 Cursor 或 Claude Code，这组文档最适合先看。先把日常工具接到 TheRouter.ai，再按需补充路由、权限和计费设置。
如果你要启用 BYOK
中文入口BYOK 适合保留你自己的供应商账号，同时继续使用 TheRouter.ai 的统一入口、路由和故障切换能力。
如果你要启用 Skills 或联网能力
中文入口Skills 适合把联网搜索、响应修复和工具封装放到服务端统一处理，减少各个客户端重复配置和维护。
如果你最关心稳定性和故障切换
中文入口这组文档会说明默认路由、供应商选择和模型回退是如何配合工作的，适合排查稳定性和故障切换问题。
如果你要统一工具调用和 schema
中文入口当你开始接工具、函数调用或跨供应商切换时，schema 兼容和输出契约通常比模型名称更值得先确认。
如果你在做排障、对账或内部结算
中文入口这组文档适合排查请求、费用和月度差异，帮助你区分日志、导出、余额和账单各自解决的问题。
下一步
- 常见问题 — 先用中文排掉最常见的模型、积分和账户疑问。
- 模型目录 — 先确认你实际要用哪些模型，再决定路由和预算策略。
- Cursor IDE Integration — 如果你的团队主要在 Cursor 里开发，优先看这页。