错误码说明
完整的错误码列表与排查解决方案
HTTP 状态码说明
常见 HTTP 状态码
| 状态码 | 说明 | 处理建议 |
|---|---|---|
| 200 | 请求成功 | 正常处理返回数据 |
| 400 | 请求参数错误 | 检查请求参数格式 |
| 401 | 未认证 | 检查 API Key 是否正确 |
| 403 | 无权限 | 检查是否已订阅该接口 |
| 404 | 接口不存在 | 检查请求 URL |
| 422 | 参数验证失败 | 查看 message 中的具体提示 |
| 429 | 频率超限 | 降低请求频率或升级套餐 |
| 500 | 服务器错误 | 稍后重试，如持续请联系客服 |
业务错误码说明
业务错误码
业务错误码通过响应体的 code 字段返回：
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 40100 | API Key 无效 |
| 40101 | API Key 已过期 |
| 40300 | 未订阅该接口 |
| 40301 | 调用次数已用尽 |
| 42200 | 缺少必填参数 |
| 42201 | 参数格式错误 |
| 50000 | 服务内部错误 |
频率限制（429）处理
频率限制机制
平台对每个 API Key 实施 QPS（每秒查询次数）和每日调用次数限制，超出限制将返回 429 状态码。
响应头
X-RateLimit-Limit: 5 // QPS 上限
X-RateLimit-Remaining: 3 // 剩余可用次数
X-RateLimit-Reset: 1700000 // 重置时间戳处理建议
- 实现指数退避重试策略
- 在客户端做请求队列，控制并发
- 如需更高 QPS，可升级套餐或联系客服
常见问题排查指南
常见问题
Q: 返回 401 Unauthorized
A: 检查 Authorization 头格式是否为 Bearer sk-xxx，确认 Key 状态为启用。
Q: 返回数据为空
A: 检查请求参数是否正确，部分接口需要特定格式的输入。
Q: 响应很慢
A: 检查网络连接，大部分接口响应时间在 100ms 以内。如持续缓慢请联系客服。
Q: 调用次数不够用
A: 可在控制台查看用量，购买更高配额的套餐或联系客服定制方案。