Error Codes
Common error codes and troubleshooting.
| Code | Message | Solution |
|---|---|---|
| 401 / 40101 | Unauthorized | Check your CV_API_KEY is valid |
| 403 / 40301 | Forbidden | Your account may lack permissions |
| 400 / 40001 | Invalid parameters | Check the named field, type, enum, pagination and range. Some existing endpoints return HTTP 200 with success=false; do not rely on HTTP status alone. |
| 40201 | Insufficient credits | Check your balance and request size. Add credits or reduce the number of results. |
| 404 | Not Found | The requested resource doesn't exist |
| 429 / 42901 | Too Many Requests | You've hit the rate limit, wait and retry |
| 500 | Internal Server Error | Contact support if persistent |
Troubleshooting
Invalid API Key
- •Verify your CV_API_KEY environment variable is set correctly
- •Check that the key hasn't been revoked in your account settings
Task Not Found
- •Ensure the task_id is correct
- •Verify task ownership and retain task_id and request_id. Do not assume every task expires after seven days.