Knowledge base

Tìm nhanh trong tài liệu Zora

Error Codes

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

Code	Name	Description
`400`	Bad Request	Invalid request body or missing required parameters
`401`	Unauthorized	Invalid or missing API key
`403`	Forbidden	Your API key is valid, but the plan does not include this model or route
`404`	Not Found	The requested model or endpoint does not exist
`429`	Rate Limited	You have exceeded your RPM limit. Wait and retry.
`500`	Internal Error	An unexpected error occurred on our side
`502`	Bad Gateway	The model route is temporarily unavailable
`503`	Service Unavailable	The requested model is temporarily unavailable

Error Response Format

JSON

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

Authentication vs Model Access

401 invalid_api_key means the key is missing, malformed, revoked, or unknown.403 model_not_allowed means the key is valid, but the selected model is not enabled on the current plan. For a first smoke test, use gpt-5.5 or another model listed as available for the account.

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