Error Codes

Zora uses standard HTTP status codes. Here are the common error responses you may encounter.

CodeNameDescription
400Bad RequestInvalid request body or missing required parameters
401UnauthorizedInvalid or missing API key
403ForbiddenYour plan does not include access to this model
404Not FoundThe requested model or endpoint does not exist
429Rate LimitedYou have exceeded your RPM limit. Wait and retry.
500Internal ErrorAn unexpected error occurred on our side
503Service UnavailableThe upstream model provider is temporarily down

Error Response Format

JSON
{ "error": { "message": "Invalid API key provided", "type": "authentication_error", "code": "invalid_api_key" } }

Rate Limiting

When you exceed your RPM limit, you'll receive a 429 response. The response headers include:

  • X-RateLimit-Limit — Your RPM limit
  • X-RateLimit-Remaining — Remaining requests this minute
  • X-RateLimit-Reset — Unix timestamp when the limit resets