API 参考
错误码与诊断
排查 API 交互中遇到的各类异常。当遇到非 200 HTTP 响应时，可以通过以下指南快速进行故障定位。
常见状态码指南
400 Bad Request
扣费处理：免费（未产生任何扣费）
请求格式错误，例如 JSON 格式不合法、必填字段（如 model）为空，或者提示词中缺少对 JSON 模式的指令。
排查建议
检查您的请求载荷，确保 JSON 闭合正确且满足 OpenAI 兼容参数字段。
401 Unauthorized
扣费处理：免费（未产生任何扣费）
API 密钥身份验证失败。密钥可能已被停用、删除或拼写输入有误。
排查建议
前往控制台令牌管理页，检查密钥激活状态。确保携带 Bearer 前缀。
403 Forbidden
扣费处理：免费（未产生任何扣费）
密钥存在策略拦截。常见原因为当前密钥开启了 IP 来源锁定、可访问的模型白名单中未包含当前请求模型，或者您所属的令牌分组额度已扣减为零。
排查建议
检查密钥属性配置；如果是余额用尽，请联系管理员或前往充值模块。
429 Too Many Requests
扣费处理：免费（未产生任何扣费）
超出频率限制。您的 RPM（每分钟连接数）或 TPM（每分钟 Token 限制）指标短期溢出。
排查建议
在客户端代码中实现指数退避重试 (Exponential Backoff)。若项目并发量极大，建议联系管理员提升对应分组配额。
500 / 502 / 503 Gateway Error
扣费处理：自动退款（由于上游未完成传输，网关会在结算环节直接发起全额退回）
外部上游模型厂商发生突发故障、崩溃或连接超时。
排查建议
此为厂商服务中继超时。系统支持高可用故障自动切换，也可以等待厂商恢复或在客户端换用备用模型。