常见报错码怎么读

400、401、402、403、404、429 与 5xx 排查。

请求与权限

400:检查必填字段、模型支持的参数和输入格式。401:核对完整 API Key、Bearer 请求头、启用状态和有效期。402:查看账户余额及额度。403:检查模型授权、分组权限和 Key 限制。

404:核对路由、HTTP 方法与模型 ID。OpenAI Base URL 带 /v1,Claude Code 不带;不要重复 /v1。模型是否可用以当前 Key 的 GET /v1/models 为准。

限流与上游故障

429:降低并发,遵循 Retry-After(如有),采用带随机抖动的指数退避。5xx:保留请求 ID、时间、模型和脱敏错误信息;确认没有创建成功后再重试有费用的图像或视频任务,避免重复扣费。

相关文章

流式响应与连接排查 ›