常见错误码与排查指南

在使用 API 的过程中，若收到非 200 OK 的 HTTP 响应，请参考下表排查原因：

HTTP 状态码	错误类型	原因分析	解决方案
401 Unauthorized	鉴权失败	1. API Key 不正确或已被禁用 2. Header 格式未加 Bearer	检查 Key 是否复制完整；确认 Header 为 Authorization: Bearer sk-xxx
402 Payment Required	额度不足	1. 账户全局余额耗尽 2. 单个 API Key 的设定配额已用完	进入控制台使用兑换码充值，或编辑该令牌调高额度上限
429 Too Many Requests	频率超限 / 上游限流	1. 请求频率超过了分组 RPM 限制 2. 上游服务商触发 Rate Limit	降低并发频次，或联系管理员切换至高并发 VIP 分组/增加上游渠道
404 Not Found	模型不存在	请求的 model 名称在网关中未被开启或打错拼写	在控制台「模型广场」或调用 /v1/models 接口确认支持的准确模型名称
502 Bad Gateway	上游通道异常	上游服务商（OpenAI/Anthropic等）服务器故障或网络中断	网关会自动尝试重试其他节点；若持续报错，请提交工单联系运维
504 Gateway Timeout	请求超时	长文本推理响应时间过长，超过网关超时限制（如 120s）	建议开启 stream: true 流式传输，或使用上下文压缩缩短 Prompt