错误码

接口错误通常包含 HTTP 状态码和可读的错误信息。排查时请同时记录请求时间、模型名称和错误消息。

状态码	含义	优先处理
400	请求参数错误	检查 JSON、必填字段和参数类型
401	认证失败	检查 API Key 和请求头
402	余额或额度不足	检查钱包余额和密钥额度
403	无权访问	检查分组、模型限制或 IP 限制
404	路径或模型不存在	检查接口地址和模型名称
429	请求过于频繁	降低并发并使用退避重试
500	服务内部错误	稍后重试并保留请求时间
502 / 503	上游暂时不可用	切换模型或等待上游恢复

错误响应示例

{
  "error": {
    "message": "错误说明",
    "type": "error_type",
    "param": null,
    "code": "error_code"
  }
}

429 重试建议

不要立即连续重试。建议采用指数退避，并为重试次数设置上限：

第 1 次：等待约 1 秒
第 2 次：等待约 2 秒
第 3 次：等待约 4 秒
之后停止并记录错误

反馈问题时提供

• 请求发生时间和时区
• 使用的接口路径
• 模型名称
• HTTP 状态码与完整错误消息
• 是否稳定复现

不要提供

不要发送 API Key、登录密码、支付信息或包含其他用户数据的完整日志截图。