# 概览

> TokRouter 是一个 OpenAI 兼容的模型网关:一个 base URL、一把 Key 接入多家厂商的模型,按输入 / 输出 / 缓存分项计价。

一句话:把 SDK 的 `base_url` 换成 `https://api.tokrouter.dev/v1`,用同一把 `sk-` 开头的 Key 调各家模型。

```bash
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": "用一句话解释什么是模型网关"}]
  }'
```

<Callout type="info" title="第一次接入">
从[快速开始](/zh/quickstart/)开始:创建令牌 → 跑通 curl → 换 SDK 的 base_url。全程不需要安装任何 TokRouter 专属依赖。
</Callout>

## 你会在文档里找到什么

- **接入**:快速开始、鉴权、计费与额度
- **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` 前缀) |

<Callout type="warn" title="System One 不是 chat 协议">
`/v1/systemone` 是 Jev 决策模型的透传端点,请求体是 `{state, questions}`、响应是带概率的类型化决策;
它不支持流式,也不参与上面四种协议的互转。
</Callout>