Skip to content

错误码

HTTP 状态码含义处理方式
400请求参数错误检查 JSON 字段、模型名和必填参数
401鉴权失败检查 API Key 是否正确、是否带有 Bearer 前缀
403无权限 / 额度不足确认 Key 是否有该模型/分组的权限;insufficient_user_quota 表示余额不足,请充值
404资源不存在检查 Endpoint、模型名是否正确(model_not_found = 模型不存在或不在你的分组内)
429频率限制降低请求频率,稍后重试
500服务端错误稍后重试,并保留请求 ID 方便排查
501功能未实现或当前模型不支持检查请求的 Endpoint、协议或模型能力;不要立即重试相同请求
502网关无法从上游服务获得有效响应使用指数退避后有限重试;持续失败时记录请求 ID 并反馈
503上游服务暂时不可用平台供应商临时故障或线路切换中,稍后重试或换用其他模型;平台会自动容灾切换备用线路

重试原则

  • 400 / 401 / 403 / 大多数 404 是请求或权限问题,修正后再重试。
  • 429 应降低并发并使用指数退避(如等待 1、2、4、8 秒后重试)。
  • 500 / 502 / 网络超时 可有限重试,建议指数退避并限制总次数。
  • 503 为上游临时故障:等待后重试通常有效;也可切换到同分组其他模型继续工作。
  • 501 表示功能不受支持,应调整请求或选择其他模型,而不是重试相同请求。

反馈问题

请提供:请求时间、HTTP 状态码、请求路径、模型名和响应中的请求 ID(如有)。不要提供 API Key。

AshPetals API — 单主站 · OpenAI 兼容