概览
TokRouter 是一个 OpenAI 兼容的模型网关:一个 base URL、一把 Key 接入多家厂商的模型,按输入 / 输出 / 缓存分项计价。
一句话:把 SDK 的 base_url 换成 https://api.tokrouter.dev/v1,用同一把 sk- 开头的 Key 调各家模型。
curl https://api.tokrouter.dev/v1/chat/completions \
-H "Authorization: Bearer $TOKROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"messages": [{"role": "user", "content": "用一句话解释什么是模型网关"}]
}'第一次接入
从快速开始开始:创建令牌 → 跑通 curl → 换 SDK 的 base_url。全程不需要安装任何 TokRouter 专属依赖。
你会在文档里找到什么
- 接入:快速开始、鉴权、计费与额度
- SDK 与框架:OpenAI Python / Node、Anthropic、LangChain、Vercel AI SDK
- 工具集成:Claude Code、Cursor、Cline、Cherry Studio、LibreChat
- 使用指南:流式输出、工具调用、视觉输入、结构化输出、协议互转
- API 参考:各协议的端点、请求与响应字段
- 模型:每个模型的上下文窗口与分项价格
支持的协议
同一个 base URL 上,网关同时接受四种入站协议,并按请求体里的 model 决定上游厂商 ——
用 Anthropic SDK 调 OpenAI 模型,或用 OpenAI SDK 调 Claude 都可以。
| 协议 | 端点 | 典型客户端 |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | OpenAI SDK、绝大多数第三方客户端 |
| OpenAI Responses | /v1/responses | OpenAI 新 Responses API |
| Anthropic Messages | /v1/messages | @anthropic-ai/sdk、Claude Code |
| Gemini | /v1beta/models/{model}:generateContent | google-genai |
| DashScope | /v1/services/aigc/text-generation/generation | 阿里云 DashScope SDK(去掉官方 /api 前缀) |
System One 不是 chat 协议
/v1/systemone 是 Jev 决策模型的透传端点,请求体是 {state, questions}、响应是带概率的类型化决策;
它不支持流式,也不参与上面四种协议的互转。