> For the complete documentation index, see [llms.txt](https://docs.mashagpt.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mashagpt.ru/api/audio.md).

# Аудио

Узнайте, как превратить аудио в текст.

## Создание транскрипции

<mark style="color:green;">`POST`</mark> `https://api.mashagpt.ru/v1/audio/transcriptions`

Конвертирует аудио в текст

:exclamation:Принимает тело запроса в формате `multipart/form-data`

#### Request Body

| Name                                    | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| file<mark style="color:red;">\*</mark>  | File   | Объект аудиофайла (не имя файла), который необходимо расшифровать, в одном из следующих форматов: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav или webm.                                                                                                                                                                                                                                                                                          |
| model<mark style="color:red;">\*</mark> | String | Идентификатор модели, которую нужно использовать. В настоящее время доступен только `whisper-1`.                                                                                                                                                                                                                                                                                                                                               |
| language                                | String | Язык входного аудио. Предоставление языка аудио в формате [ISO-639-1 ](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)улучшит точность и время обработки.                                                                                                                                                                                                                                                                               |
| prompt                                  | String | Дополнительный текст, определяющий стиль модели или продолжающий предыдущий сегмент аудио. Подсказка должна соответствовать языку аудио.                                                                                                                                                                                                                                                                                                       |
| response\_format                        | String | <p>Формат вывода: один из следующих вариантов: <code>json</code>, <code>text</code>, <code>srt</code>, <code>verbose\_json</code> или <code>vtt</code>.<br>По умолчанию используется <code>json</code>.</p>                                                                                                                                                                                                                                    |
| temperature                             | Number | Температура выборки от 0 до 1. Более высокие значения, например 0,8, сделают выходные данные более случайными, а более низкие значения, например 0,2, сделают их более детерминированными. Если установлено значение 0, модель будет использовать [логарифмическую вероятность](https://en.wikipedia.org/wiki/Log_probability) для автоматического повышения температуры до тех пор, пока не будут достигнуты определенные пороговые значения. |

{% tabs %}
{% tab title="200: OK Транскрипция текста JSON" %}

```json
{
  "text": "Imagine the wildest idea that you've ever had, and you're curious about how it might scale to something that's a 100, a 1,000 times bigger. This is a place where you can get to do that."
}
```

{% endtab %}
{% endtabs %}

{% code title="Пример запроса" lineNumbers="true" %}

```bash
curl https://api.mashagpt.ru/v1/audio/transcriptions \
  -H "Authorization: Bearer $MASHAGPT_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F file="@/path/to/file/audio.mp3" \
  -F model="whisper-1"
```

{% endcode %}

{% code title="Пример ответа" lineNumbers="true" %}

```json
{
  "text": "Imagine the wildest idea that you've ever had, and you're curious about how it might scale to something that's a 100, a 1,000 times bigger. This is a place where you can get to do that."
}
```

{% endcode %}

***

## Создание перевода

<mark style="color:green;">`POST`</mark> `https://api.mashagpt.ru/v1/audio/translations`

Переводит аудио на английский язык

:exclamation:Принимает тело запроса в формате `multipart/form-data`

#### Request Body

| Name                                    | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| file<mark style="color:red;">\*</mark>  | File   | Объект аудиофайла (не имя файла), который необходимо расшифровать, в одном из следующих форматов: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav или webm.                                                                                                                                                                                                                                                                                          |
| model<mark style="color:red;">\*</mark> | String | Идентификатор модели, которую нужно использовать. В настоящее время доступен только `whisper-1`.                                                                                                                                                                                                                                                                                                                                               |
| prompt                                  | String | Дополнительный текст, определяющий стиль модели или продолжающий предыдущий сегмент аудио. Подсказка должна соответствовать языку аудио.                                                                                                                                                                                                                                                                                                       |
| response\_format                        | String | <p>Формат вывода: один из следующих вариантов: <code>json</code>, <code>text</code>, <code>srt</code>, <code>verbose\_json</code> или <code>vtt</code>.<br>По умолчанию используется <code>json</code>.</p>                                                                                                                                                                                                                                    |
| temperature                             | Number | Температура выборки от 0 до 1. Более высокие значения, например 0,8, сделают выходные данные более случайными, а более низкие значения, например 0,2, сделают их более детерминированными. Если установлено значение 0, модель будет использовать [логарифмическую вероятность](https://en.wikipedia.org/wiki/Log_probability) для автоматического повышения температуры до тех пор, пока не будут достигнуты определенные пороговые значения. |

{% tabs %}
{% tab title="200: OK Перевод аудио на английский язык" %}

```json
{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you heading today?"
}
```

{% endtab %}
{% endtabs %}

{% code title="Пример запроса" lineNumbers="true" %}

```bash
curl https://api.mashagpt.ru/v1/audio/translations \
  -H "Authorization: Bearer $MASHAGPT_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F file="@/path/to/file/german.m4a" \
  -F model="whisper-1"
```

{% endcode %}

{% code title="Пример ответа" lineNumbers="true" %}

```json
{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you heading today?"
}
```

{% endcode %}
