Errors

{
  "error": {
    "type": "text_too_long",
    "message": "'text' must be 2000 characters or fewer.",
    "request_id": "3f2a9c1e5b7d4e8fa0c2b6d9e1f3a5c7"
  }
}

string

A stable code. Branch on this.

string

What happened, for developers. It may change; do not parse it.

string

The same as the X-Request-Id header. Send it to us with any question about a request.

Status	Codes
`400`	`invalid_request`, `invalid_json`, `missing_text`, `missing_file`, `empty_audio`, `unknown_voice`, `unsupported_language`, `unsupported_pair`, `unknown_persona`
`401`	`missing_api_key`, `invalid_api_key`, `key_revoked`
`403`	`insufficient_scope`, `account_paused`
`404`	`not_found`
`405`	`method_not_allowed`
`413`	`payload_too_large`, `audio_too_long`, `text_too_long`
`415`	`unsupported_audio`
`422`	`nothing_heard`
`429`	`rate_limited`, `quota_exceeded`
`500`	`internal_error`, `encode_failed`
`502`	`upstream_error`
`503`	`auth_unavailable`
`504`	`upstream_timeout`

What each one means and what to do: the errors guide.

Overview

Speech

Transcription

Translation

Voice agent

Models and voices

Account