ToRouter 文档核心概念
ToRouter 的五个名词心智模型——账号、渠道、模型、Key、配额。
ToRouter 只有五个名词。理解了它们，其他文档就一目了然。
五个名词
账号（Account）
你的 ToRouter 用户，在 portal.torouter.ai 用邮箱 + 密码创建。一个账号持有账户余额（预付额度）并可创建任意数量的 API Key。
渠道（Channel）
上游供应商连接——ToRouter 托管的 OpenAI / Anthropic / Gemini / OpenRouter / DeepSeek / Qwen / Bedrock / Replicate 等账号。普通用户不直接管理上游绑定；你能访问哪些模型由控制台中的订阅与访问权限决定，你通过模型清单间接感知可用路由。
模型（Model）
你在 model 字段里传入的标识，例如 gpt-5、claude-opus-4-7、gemini-2.5-pro、deepseek-v3 等。请求到达后，ToRouter 会在你有权访问的上游路由中挑选支持该模型的渠道并转发。详见 模型字符串。
API Key
你放在 Authorization 头中的 sk-***。在控制台创建，每个 Key 可独立配置：
- 消费配额
- 速率限制（RPM / TPM）
- IP 白名单（CIDR）
- 模型白名单
- 有效期
详见 单 Key 限制。
配额（Quota）
请求时实际生效的配额是三者最小值：账户余额、订阅套餐带来的月度额度（若有）、Key 自身的额度。任何一项耗尽都会让请求失败。
一次请求的链路
客户端 SDK
| Authorization: Bearer sk-***
v
ToRouter 网关
| Key → 账号 → 访问权限（订阅）
v
模型路由
| 挑选支持该 model 的上游渠道
v
上游供应商（OpenAI / Anthropic / Gemini / ...）
|
v
返回响应 + 用量写入仪表盘你始终只持有一个 Key 和一个 Base URL。从 gpt-5 切到 claude-opus-4-7 只需改 model 字段一行——不用新建账号、也不换凭证。