错误码
常见错误响应与处理方式
错误码
错误响应统一为 JSON 格式：
{
"error": {
"message": "错误描述",
"type": "错误类型",
"code": "错误码"
}
}常见错误
| HTTP 状态 | 场景 | 处理建议 |
|---|---|---|
| 400 | 参数错误（模型名不存在、参数越界、时长超限等） | 对照接口文档检查请求体 |
| 401 | 令牌缺失、无效或已禁用 | 检查 Authorization 头与令牌状态 |
| 403 | 用户被封禁 / IP 不在令牌白名单 / 无权限访问该分组 | 检查账号状态与令牌配置 |
| 429 | 触发限流 / 上游负载饱和 | 降低频率后重试，任务类可稍后重试 |
| 500/502/503 | 上游服务异常 | 稍后重试；持续出现请联系客服 |
| 413 | 请求体过大 | 减小请求体（如缩短 prompt、减少图片） |
额度相关错误
- 余额不足（预扣失败）：对话请求按 max_tokens 预估、任务按上限预扣，余额不足会直接拒绝，充值后重试
- 令牌额度耗尽：令牌自身额度用完（账号仍有余额），可在令牌页面调大或新建令牌
重试建议
- 429/5xx 可指数退避重试（1s、2s、4s…）
- 400 类错误不要重试，先修正请求
- 平台内部已做渠道级自动重试，客户端无需对单一错误反复尝试
这篇文档对您有帮助吗？