Errors & limits

Ozeye returns standard HTTP status codes with JSON error bodies.

{
  "error": {
    "message": "description of the problem",
    "type": "invalid_request_error",
    "code": 400
  }
}

Common status codes

400 Bad Request

Invalid JSON, missing required field, invalid preset, unsupported model modality, or invalid file.

401 Unauthorized

Missing, expired, revoked, or invalid API key/session.

402 Payment Required

Insufficient credits or key credit limit reached.

404 Not Found

Route, model, preset, notebook file, or session not found.

409 Conflict

Notebook file changed since supplied ETag, key limit reached, or invalid state transition.

429 Too Many Requests

Rate limit exceeded. Retry after the indicated delay.

503 Service Unavailable

Provider unavailable, billing not configured, or cloud notebook mode unavailable.

Body limits

  • Chat completions: 1 MB request body.
  • Audio transcription: 25 MB decoded audio.
  • Image generation: 10 MB request body.
  • Notebook sync/save: 2 MB request body.
  • Webhook payloads: 1 MB.