错误码参考

不同网关与上游模型返回的错误字段结构可能不完全一致。排障时优先记录 HTTP 状态码、错误消息和 Request ID。

常见状态码

状态码	含义	优先处理
400	请求格式错误	检查 JSON、必填字段和参数类型
401	未认证或密钥无效	检查 Key、Bearer 头和密钥状态
403	无权限	检查模型权限、账户状态或访问限制
404	路径或模型不存在	检查 Base URL、路径和模型调用名
413	请求体过大	缩短输入、附件或上下文
422	参数无法处理	检查模型是否支持当前参数
429	请求过多或额度受限	降低频率并遵循重试等待
500	服务内部错误	稍后重试并记录 Request ID
502	上游响应异常	稍后重试，持续出现时反馈
503	服务暂时不可用	延迟重试，不要高频轰炸
504	上游超时	缩短请求、降低并发并重试

401 Unauthorized

常见原因：

• 没有发送 API Key
• Key 复制不完整
• Key 已删除
• 请求头格式错误
• 使用了其他平台的 Key

正确格式：

Authorization: Bearer sk-your-key

404 Not Found

先检查最终请求 URL：

正确：https://api.lowprice.one/v1/models
错误：https://api.lowprice.one/v1/v1/models

如果路径正确，再检查模型调用名是否已经下线或不可用。

429 Too Many Requests

这通常不代表密钥失效。可能原因包括：

• 短时间内请求过多
• 并发过高
• 当前账户额度或速率受限
• 上游模型繁忙

处理方式：

1. 停止无上限的立即重试
2. 使用指数退避和抖动
3. 降低并发
4. 检查控制台额度
5. 如果响应包含 Retry-After，遵循该等待时间

5xx 错误

500、502、503、504 可能来自网关或上游模型服务。短时间、低频、有限次数的重试是合理的；持续出现时请带上 Request ID 联系支持。

提供错误信息时

请提供脱敏后的响应：

{
  "code": "错误代码",
  "message": "错误消息"
}

不要提交完整 API Key、真实用户输入或其他敏感数据。