> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tazolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Exceptions shared by the sync and async clients.

Exceptions shared by the sync and async clients.

### TazoError

```python theme={null}
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

```python theme={null}
exception tazo.errors.AuthenticationError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.PermissionDeniedError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.InvalidRequestError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.NotFoundError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.RequestTooLargeError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`InvalidRequestError`](#tazo.errors.InvalidRequestError "tazo.errors.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

```python theme={null}
exception tazo.errors.RateLimitError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.IdempotencyConflictError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.DecisionPendingError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.ConnectionError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.TimeoutError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.ProtocolError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.ServiceError(message, *, status_code=None, code=None, request_id=None, idempotency_key=None, retryable=False, retry_after=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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

```python theme={null}
exception tazo.errors.StreamingError(message, *, code=None, close_code=None)
```

Bases: [`TazoError`](#tazo.errors.TazoError "tazo.errors.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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.