Errors & limits

Error shape

All HTTP errors return a JSON body:

{
  "error": {
    "message": "Daily character quota exceeded",
    "type": "quota_error"
  }
}

Some quota_error responses include an additional detail field.

Status	`type`	Meaning
`401`	`auth_error`	Missing, malformed, or revoked API key.
`400`	`proxy_error`	Bad request — e.g. unknown `voice` or empty `input`.
`429`	`quota_error`	Daily character quota exhausted, or request rate exceeded.
`502`	`proxy_error`	Upstream synthesis failure.
`500`	`server_error`	Unexpected gateway error.

On the WebSocket stream, errors arrive as a control frame instead:

{ "type": "error", "message": "Send a 'start' frame first" }

Need a higher limit? Reach out through the playground’s help page.

⌘I