API 基础
错误排查与重试
先记录 HTTP 状态码与响应中的错误信息，再结合控制台调用日志排查；不要在工单或截图中公开完整密钥。
1
章节 1
检查请求和账号
4xx 错误通常先检查请求参数、密钥、模型标识、账户余额和限制。具体含义以接口实际返回信息为准。
- 401：核对 Bearer 密钥、空格和密钥状态
- 400 或 404：核对接口路径、请求体与模型标识
- 429：降低并发，稍后再试，并查看账号或模型的限制
2
章节 2
处理暂时性失败
超时或 5xx 错误可能是临时故障。可以对可重试请求使用有限次数的指数退避，但避免无限重试造成重复消耗。
- 先检查网络、超时配置和控制台公告
- 记录请求时间、模型和错误信息，便于客服定位
- 对可能产生费用或副作用的请求，重试前先核对调用记录
3
章节 3
提交问题
仍无法解决时，通过客服入口提供账号标识、模型名称、请求时间和脱敏错误信息。不要发送完整 API Key、支付密码或验证码。