# Audio.Transcriptions

## Overview

API for audio transcription.

### Available Operations

* [complete](#complete) - Create Transcription
* [stream](#stream) - Create Streaming Transcription (SSE)

## complete

Create Transcription

### Example Usage

<!-- UsageSnippet language="python" operationID="audio_api_v1_transcriptions_post" method="post" path="/v1/audio/transcriptions" example="userExample" -->
```python
from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.audio.transcriptions.complete(model="voxtral-mini-latest", diarize=False)

    # Handle response
    print(res)

```

### Parameters

| Parameter                                                                                                                                                                                                                   | Type                                                                                                                                                                                                                        | Required                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                 | Example                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                                                                                                                                     | *str*                                                                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                                                                          | ID of the model to be used.                                                                                                                                                                                                 | **Example 1:** voxtral-mini-latest<br/>**Example 2:** voxtral-mini-2507                                                                                                                                                     |
| `file`                                                                                                                                                                                                                      | [Optional[models.File]](../../models/file.md)                                                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |                                                                                                                                                                                                                             |
| `file_url`                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | Url of a file to be transcribed                                                                                                                                                                                             |                                                                                                                                                                                                                             |
| `file_id`                                                                                                                                                                                                                   | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | ID of a file uploaded to /v1/files                                                                                                                                                                                          |                                                                                                                                                                                                                             |
| `language`                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | Language of the audio, e.g. 'en'. Providing the language can boost accuracy.                                                                                                                                                |                                                                                                                                                                                                                             |
| `temperature`                                                                                                                                                                                                               | *OptionalNullable[float]*                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |                                                                                                                                                                                                                             |
| `diarize`                                                                                                                                                                                                                   | *Optional[bool]*                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |                                                                                                                                                                                                                             |
| `context_bias`                                                                                                                                                                                                              | List[*str*]                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |                                                                                                                                                                                                                             |
| `speaker_references`                                                                                                                                                                                                        | Dict[str, *str*]                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | Dictionary of speaker names and reference audios for speakers who are known to appear in the audio. When enabled, diarize must be true. Predicted speakers will be matched against reference speakers from this dictionary. |                                                                                                                                                                                                                             |
| `timestamp_granularities`                                                                                                                                                                                                   | List[[models.TimestampGranularity](../../models/timestampgranularity.md)]                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                          | Granularities of timestamps to include in the response.                                                                                                                                                                     |                                                                                                                                                                                                                             |
| `retries`                                                                                                                                                                                                                   | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md)                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | Configuration to override the default retry behavior of the client.                                                                                                                                                         |                                                                                                                                                                                                                             |

### Response

**[models.TranscriptionResponse](../../models/transcriptionresponse.md)**

### Errors

| Error Type      | Status Code     | Content Type    |
| --------------- | --------------- | --------------- |
| errors.SDKError | 4XX, 5XX        | \*/\*           |

## stream

Create Streaming Transcription (SSE)

### Example Usage

<!-- UsageSnippet language="python" operationID="audio_api_v1_transcriptions_post_stream" method="post" path="/v1/audio/transcriptions#stream" -->
```python
from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.audio.transcriptions.stream(model="Camry", diarize=False)

    with res as event_stream:
        for event in event_stream:
            # handle event
            print(event, flush=True)

```

### Parameters

| Parameter                                                                                                                                                                                                                   | Type                                                                                                                                                                                                                        | Required                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                                                                                                                                     | *str*                                                                                                                                                                                                                       | :heavy_check_mark:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |
| `file`                                                                                                                                                                                                                      | [Optional[models.File]](../../models/file.md)                                                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |
| `file_url`                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | Url of a file to be transcribed                                                                                                                                                                                             |
| `file_id`                                                                                                                                                                                                                   | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | ID of a file uploaded to /v1/files                                                                                                                                                                                          |
| `language`                                                                                                                                                                                                                  | *OptionalNullable[str]*                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                          | Language of the audio, e.g. 'en'. Providing the language can boost accuracy.                                                                                                                                                |
| `temperature`                                                                                                                                                                                                               | *OptionalNullable[float]*                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |
| `diarize`                                                                                                                                                                                                                   | *Optional[bool]*                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |
| `context_bias`                                                                                                                                                                                                              | List[*str*]                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                          | N/A                                                                                                                                                                                                                         |
| `speaker_references`                                                                                                                                                                                                        | Dict[str, *str*]                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | Dictionary of speaker names and reference audios for speakers who are known to appear in the audio. When enabled, diarize must be true. Predicted speakers will be matched against reference speakers from this dictionary. |
| `timestamp_granularities`                                                                                                                                                                                                   | List[[models.TimestampGranularity](../../models/timestampgranularity.md)]                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                          | Granularities of timestamps to include in the response.                                                                                                                                                                     |
| `retries`                                                                                                                                                                                                                   | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md)                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                          | Configuration to override the default retry behavior of the client.                                                                                                                                                         |

### Response

**[Union[eventstreaming.EventStream[models.TranscriptionStreamEvents], eventstreaming.EventStreamAsync[models.TranscriptionStreamEvents]]](../../models/.md)**

### Errors

| Error Type      | Status Code     | Content Type    |
| --------------- | --------------- | --------------- |
| errors.SDKError | 4XX, 5XX        | \*/\*           |