Error codes

Error shape

{
  "error": {
    "code": "invalid_audio_format",
    "message": "Unsupported audio encoding: mp3 over websocket",
    "request_id": "req_01J8..."
  }
}

Include the request_id when reporting a problem — it lets us find the request.

Common codes

code	HTTP	What to do
unauthorized	401	Check the API key is correct and has not expired
quota_exceeded	429	Concurrency or quota limit reached; retry later or contact us to raise it
invalid_audio_format	400	The live interface accepts PCM only; decode compressed formats first
glossary_not_found	404	Check the glossary_id; test and production environments are separate
session_expired	410	More than five minutes since disconnection; open a new session

Retry policy

Retry 429 and 5xx with exponential backoff. Other 4xx responses will not succeed on retry — fix the request instead.