接入文档
错误码大全
HTTP 状态码、业务错误码和重试策略。
本页是稳定的错误码索引。遇到具体问题时，可从问题排查开始。
HTTP 状态码
| 状态码 | 含义 | 建议 |
|---|---|---|
| 400 | 请求体或参数不合法 | 修正参数后再试 |
| 401 | 未鉴权或密钥无效 | 检查 Bearer Token 和密钥状态 |
| 403 | 权限不足或模型不允许 | 检查角色、密钥白名单和模型可用范围 |
| 429 | 触发限流 | 等几秒后再试 |
| 500 | 平台内部错误 | 稍后重试，并记录 request id |
| 502 / 503 | 服务暂时中断 | 稍后重试，或切换到其他模型 |
业务错误码
| 错误码 | 含义 | 建议 |
|---|---|---|
INSUFFICIENT_BALANCE | 团队余额不足 | 前往钱包充值，或联系所有者处理 |
KEY_DISABLED | 密钥已禁用或被删除 | 换用其他密钥，或重新启用此密钥 |
MODEL_NOT_ALLOWED | 该模型不在可用范围内 | 调整密钥白名单或选择其他模型 |
RATE_LIMITED | 请求太频繁 | 降低请求频率，稍后再试 |
UPSTREAM_FAILED | 调用失败 | 稍后重试；如持续失败，请附上 request id 联系支持 |