Error Codes

Fresh

The API uses JSON responses with 2xx codes for success and 4xx/5xx for errors.

Error Reference

Code	Name	Description	Solution
401	Incorrect API Key	Authentication failed	Verify API key, clear browser cache, or generate a new key
429	Rate Limit Exceeded	Too many requests	Pace requests, implement exponential backoff
500	Server Error	Internal server error	Retry after a brief wait; contact support if persistent
503	Engine Overloaded	Service temporarily unavailable	Retry after a brief wait; contact support if persistent

Error Response Format

{
  "error": {
    "message": "Description of what went wrong",
    "type": "error_type",
    "code": 401
  }
}

Retry Strategy

WARNING

For 429 and 503 errors, always implement exponential backoff rather than immediate retries. Start with a 1-second delay and double it with each retry.

See Also

• Rate Limits — Tier-based limits
• Authentication — API key setup