ToRouter 文档故障排查
Key 被冻结或撤销
昨天还能用的 Key 今天突然失效 —— 原因与恢复方式。
昨天还能正常请求的 Key 今天被拒了。一般有五种原因。
Key 失效的原因
恢复步骤
读响应体
响应里的类型代码能区分：INVALID_API_KEY、API_KEY_DISABLED、API_KEY_EXPIRED、ACCESS_DENIED、API_KEY_QUOTA_EXHAUSTED、USER_INACTIVE，对照上面的折叠说明。
在 /keys 打开该 Key
如果列表里还在，点进详情面板，可以看到过期、IP 白名单、模型白名单、配额、最近使用 IP。
修正配置或轮换
- 限制配错 → 在控制台改对应项后重试。
- Key 被撤销 / 丢失 / 泄漏 → 新建 Key、复制、上线。
- 配额太低 → 调高；如果是账号余额空了就充值。
用一次请求验证
curl https://portal.torouter.ai/v1/chat/completions \
-H "Authorization: Bearer sk-NEW" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5","messages":[{"role":"user","content":"ping"}]}'不要把可用 Key 粘到聊天记录、日志、截图里。Key 只在创建时显示一次 —— 一旦丢失，立刻轮换。