错误处理
根据 HTTP 状态码判断认证、请求、限流和上游错误。
调用失败时先读取 HTTP 状态码，再保存响应体中的错误信息和请求时间。不要记录完整 API Key 或包含 敏感数据的请求正文。
| 状态码 | 含义 | 建议处理 |
|---|---|---|
400 | 请求字段或格式不正确 | 检查 JSON、模型名和 messages；修正后再提交 |
401 | API Key 缺失、失效或被停用 | 检查 Bearer Header 和控制台令牌状态 |
402 | 可用额度不足 | 查看余额、令牌额度和控制台消费日志 |
404 | 路径或模型不存在 | 使用 /v1/chat/completions 和公开模型全名 |
429 | 请求过多或当前资源受限 | 降低并发；响应包含 Retry-After 时按其等待 |
5xx | 平台或上游暂时失败 | 保存错误信息，短暂退避后再试；持续失败时停止自动重试 |
推荐重试边界
400、401、402、404需要修改请求或账号状态，不应原样循环重试；429和临时5xx可以进行有限次数的指数退避；- 同一个应用应设置总超时、最大重试次数和并发上限；
- 如果无法确认上一次请求是否已经完成，不要无限并发补发相同业务操作。
联系支持时提供请求时间、模型名、HTTP 状态码和脱敏后的错误信息，不要发送完整 API Key。