Errors

Error format

Requests rejected before reaching a model (authentication, balance, quotas) return:

Errors during a model call are returned in the format of the protocol you used, for example Anthropic:

or OpenAI:

Common errors

Retry guidance

4xx errors (except 429) usually need a change to the request; don't retry blindly; Retry 429, 500, 502 and 503 with exponential backoff, for example 1s, 2s, 4s; Include the X-Client-Request-ID response header when reporting a problem.