首页/AI/AI 应用速查/API 常见错误码速查
本包目录(159 条)

API 常见错误码速查

排错看状态码定位大类:400 请求结构错;401 鉴权失败;403 权限/区域;404 模型或路径不存在;429 限流/配额;500/503 服务端故障(可重试)。

AI 应用速查AI更新于 2026-10-12

错误码与处理动作

状态码含义处理
400参数/结构错误读 error.message 定位字段
401鉴权失败查 key 与鉴权头名
403权限/区域限制查项目权限与区域设置
404模型/路径不存在核对模型名与 base_url
429限流/配额超限退避重试并查配额
500/503服务端故障指数退避重试

只看状态码(不输出正文)

只看状态码(不输出正文)
curl -s -o /dev/null -w "%{http_code}
" https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"
# 需要细节时加 -i 查看响应头与错误体
OpenAI 系错误体为 error.type / error.code / error.message 三件套;写日志时保留三者便于定位与工单。

易错点

  • 把 429 当业务失败直接抛给用户(应退避重试)
  • 忽略 400 错误信息里已经指出的字段名

数据来源与参考

  • OpenAI 错误码文档;RFC 9110 HTTP 语义

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌