ToRouter 文档API 密钥
限制密钥可调用的模型
用逗号分隔的模型 ID 限定单个 ToRouter 密钥可用的模型。留空则继承分组目录。
密钥的模型白名单是一份逗号分隔的模型 ID 列表，表示该密钥允许调用的模型。判定在调上游之前完成。
行为
| 白名单 | 效果 |
|---|---|
| 空 | 可调用所订阅分组目录里的全部模型 |
| 有 | 仅可调用列表中的模型 |
model 不在白名单内的请求返回 403 model_not_allowed，不计费。
格式
逗号分隔、无需引号，两侧空白会被忽略。
gpt-5, gpt-5-mini, claude-opus-4-7, gemini-3-flash-previewOpenRouter 风格的厂商前缀按字面匹配：
anthropic/claude-opus-4-7, google/gemini-2.5-proToRouter 内部会剥离 -thinking 后缀，因此写 claude-opus-4-7 同时覆盖 claude-opus-4-7 与 claude-opus-4-7-thinking。写基础 ID 即可覆盖思考变体。
使用场景
- 把便宜密钥（如聊天机器人用）锁死在
gpt-5-mini，避免claude-opus-4-7把预算打爆。 - 给同事一个只能调 embeddings 的密钥。
- 让试用密钥只能跑当前评估的某一个模型。
配置
API 密钥 → 编辑 → 模型白名单 字段 → 保存。
可在 模型目录 或 GET /v1/models（见 Base URL）中查询模型 ID。