Errors

Braiv API errors use a structured JSON response compatible with common ElevenLabs client handling.

{
  "detail": [
    {
      "loc": ["body", "text"],
      "msg": "Text is required.",
      "type": "value_error.missing"
    }
  ]
}

Status codes

Status	Meaning	Typical cause
401	Unauthorized	Missing, malformed, deleted, or unknown API key.
403	Forbidden	API key belongs to an account without Pro or Business API access.
404	Not found	Voice id does not exist or is not owned by the API key’s user.
422	Validation error	Request body is invalid or missing required fields.
429	Too many requests	The API key has reached its concurrent request limit.
502	Upstream error	Braiv Speech could not complete the synthesis request.

Retry guidance

Retry 429 responses with exponential backoff. For 502, retry only if the request is idempotent and your integration can tolerate duplicate generated outputs.

Do not retry 401, 403, 404, or 422 without changing the request.