常见错误码与排查

在调用接口遇到异常状态码时，可参考以下对照表快速排查定位问题：

---

状态码对照表

HTTP 状态码	错误类型 (Error Type)	原因与排查步骤
401 Unauthorized	invalid_api_key	API Key 无效或未提供。 请检查请求头是否包含了 Authorization: Bearer sk-xxxx，确认没有多余的空格或字符。
403 Forbidden	insufficient_quota	账户额度不足。 主账户可用额度已耗尽，或该特定 API Key 设置的专属额度上限已达标。请充值或前往控制台调高令牌额度限制。
404 Not Found	model_not_found / 404 page not found	1. Base URL 配置错误：多写或少写了 /v1（请检查客户端设置）。 2. 模型名称拼写错误或该模型不在当前分组渠道支持列表中。
429 Too Many Requests	rate_limit_exceeded	触发并发或频次限制。 系统对单账号请求速率有保护策略。如需更高并发，请联系管理员升级至企业专属通道。
500 / 502 / 504	server_error	上游提供商响应超时或异常。 网关内部具备自动重试机制。若持续出现，可能是上游节点临时网络波动，稍等片刻重试即可。