API 错误码与排障

先看 HTTP 状态码和错误响应。修改请求前，保留请求 ID 和准确时间。

状态码	含义	检查项
400	请求无效，或字段与模型组合不支持	请求体、必填字段、模型能力和上下文上限
401	Key 缺失、无效或已停用	域名、鉴权请求头和环境变量
403	当前 Key 不能使用指定模型	Key 的模型权限和准确模型 ID
429	余额、额度或速率限制	余额、Key 限额和 retry-after
500–504、529	临时服务异常或模型供应商异常	仅对可安全重复的请求做有限指数退避重试

重试前检查

• 400、401、403 应先修正请求，不要原样循环重试。
• 返回 retry-after 时按该时间等待。
• 临时错误应设置重试上限并加入随机抖动。
• 可能产生重复任务或重复扣费的操作，不要自动重放。

联系支持

请提供时间与时区、端点、状态码、模型、请求 ID、是否流式、客户端名称和版本，并附上脱敏后的错误响应。不要提供完整 Key 或私密提示词。

完整证据清单见技术支持。