Errors

Exceptions shared by the sync and async clients.

TazoError

exception tazo.errors.TazoError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: Exception Base SDK error with recovery metadata and no stored credentials or audio.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

AuthenticationError

exception tazo.errors.AuthenticationError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError Missing or rejected bearer credential.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

PermissionDeniedError

exception tazo.errors.PermissionDeniedError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError The authenticated caller lacks access.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

InvalidRequestError

exception tazo.errors.InvalidRequestError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError Invalid local input or an HTTP 400/422 rejection.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

NotFoundError

exception tazo.errors.NotFoundError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError The requested model was not found.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

RequestTooLargeError

exception tazo.errors.RequestTooLargeError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: InvalidRequestError Audio or request exceeds the service’s size limit.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

RateLimitError

exception tazo.errors.RateLimitError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError Account admission limit reached; inspect retry_after.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

IdempotencyConflictError

exception tazo.errors.IdempotencyConflictError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError An operation key was reused with different input.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

DecisionPendingError

exception tazo.errors.DecisionPendingError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError Accepted work continues. Retain the key and retry the same input later.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

ConnectionError

exception tazo.errors.ConnectionError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError Transport connection failed; acceptance may be uncertain for writes.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

TimeoutError

exception tazo.errors.TimeoutError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError A network timeout or the overall operation deadline was reached.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

ProtocolError

exception tazo.errors.ProtocolError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError The server response doesn’t match the public contract.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

ServiceError

exception tazo.errors.ServiceError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)

Bases: TazoError The service returned an unsuccessful response.

Parameters:
- message (str)
- status_code (int *|*None)
- code (str *|*None)
- request_id (str *|*None)
- idempotency_key (str *|*None)
- retryable (bool)
- retry_after (float *|*None)
Return type: None

StreamingError

exception tazo.errors.StreamingError(message, *, code=None, close_code=None)

Bases: TazoError A fatal streaming failure or unexpected disconnect; audio is never replayed.

Parameters:
- message (str)
- code (str *|*None)
- close_code (int *|*None)
Return type: None

Get started

Guides

Python reference

TazoError

AuthenticationError

PermissionDeniedError

InvalidRequestError

NotFoundError

RequestTooLargeError

RateLimitError

IdempotencyConflictError

DecisionPendingError

ConnectionError

TimeoutError

ProtocolError

ServiceError

StreamingError

​TazoError

​AuthenticationError

​PermissionDeniedError

​InvalidRequestError

​NotFoundError

​RequestTooLargeError

​RateLimitError

​IdempotencyConflictError

​DecisionPendingError

​ConnectionError

​TimeoutError

​ProtocolError

​ServiceError

​StreamingError

TazoError

AuthenticationError

PermissionDeniedError

InvalidRequestError

NotFoundError

RequestTooLargeError

RateLimitError

IdempotencyConflictError

DecisionPendingError

ConnectionError

TimeoutError

ProtocolError

ServiceError

StreamingError