错误码
常见错误码和故障排查。
| 错误码 | 消息 | 解决方案 |
|---|---|---|
| 401 / 40101 | Unauthorized | 检查你的 CV_API_KEY 是否有效 |
| 403 / 40301 | Forbidden | 你的账号可能缺少权限 |
| 400 / 40001 | Invalid parameters | 按错误消息定位字段，核对类型、枚举、分页和范围。部分既有接口以 HTTP 200 返回 success=false，不能仅凭 HTTP 状态判断成功。 |
| 40201 | Insufficient credits | 检查账户余额和请求规模，充值或减少结果数量后重试。 |
| 404 | Not Found | 请求的资源不存在 |
| 429 / 42901 | Too Many Requests | 已达到频率限制，等待后重试 |
| 500 | Internal Server Error | 如持续出现请联系支持 |
故障排查
Invalid API Key
- •确认 CV_API_KEY 环境变量设置正确
- •检查密钥是否在账号设置中被撤销
Task Not Found
- •确保 task_id 正确
- •确认任务属于当前账户，并保存 task_id 与 request_id 排查；不要假定所有任务统一在 7 天后过期。