401 / 403：认证与权限
401 只与密钥有关：没带密钥、前缀不是 sk-、令牌被禁用或已过期；403 与权限有关：模型不在令牌的模型配置内，或命中了 IP 白名单限制。
最后更新：2026-11-14
401 常见原因
| 报错 | 含义 |
|---|---|
missing api key |
请求没带密钥 |
invalid key format |
密钥前缀不对（应为 sk- 开头） |
invalid or disabled api key |
密钥无效或已被禁用 |
api key expired |
令牌已过有效期 |
处理：确认认证头（Anthropic 用 x-api-key，OpenAI 用 Authorization: Bearer，Gemini 用 x-goog-api-key）；到「令牌管理」检查状态与有效期。
403 常见原因
| 报错 | 含义 |
|---|---|
model ... is not allowed for this api key |
模型不在令牌绑定的模型配置内 |
ip whitelist ... / ip access control ... |
命中了 IP 白名单/黑名单（后者来自令牌组 / 模型配置） |
model_offline |
模型已下架 |
处理：到「令牌管理」检查模型配置、IP 白名单；企业用户还要检查令牌组、模型配置上的 IP 访问控制。