# Аудио входные данные

> Отправляйте аудиофайлы моделям с поддержкой речи через API RouterAI.

RouterAI поддерживает отправку аудиофайлов совместимым моделям через API. Это руководство покажет вам, как работать с аудио, используя наш API.

**Примечание**: Аудиофайлы должны быть **закодированы в base64** - прямые URL не поддерживаются для аудиоконтента.

## Аудио входные данные

Запросы с аудиофайлами к совместимым моделям доступны через API [`/api/v1/chat/completions`](https://routerai.ru/docs/reference#tag/chat-completions) с типом контента `input_audio`. Аудиофайлы должны быть закодированы в base64 и включать спецификацию формата. Обратите внимание, что только модели с возможностями обработки аудио будут обрабатывать эти запросы.

Вы можете найти модели с поддержкой аудио, отфильтровав по модальности аудио входа на нашей [странице моделей](/models?input_modalities[]=audio).

### Отправка аудиофайлов

Чтобы отправить аудиофайл, закодируйте его в base64 и передайте в массиве `content` сообщения с типом `input_audio`. Вместе с аудио укажите текстовый блок с вашим вопросом или инструкцией.

Структура запроса:

1. `type: "input_audio"` — тип блока контента для аудио
2. `input_audio.data` — содержимое файла, закодированное в base64
3. `input_audio.format` — формат файла (`wav`, `mp3`, `flac` и др.)

#### Пример запроса cURL

```bash
BASE64_AUDIO=$(base64 -w 0 ./audio.wav)

curl -X POST https://routerai.ru/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ROUTERAI_API_KEY" \
  -d @- << EOF
{
  "model": "openai/gpt-audio",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Пожалуйста, расшифруйте этот аудиофайл."
        },
        {
          "type": "input_audio",
          "input_audio": {
            "data": "$BASE64_AUDIO",
            "format": "wav"
          }
        }
      ]
    }
  ]
}
EOF  
```

### Поддерживаемые форматы аудио

Поддерживаемые форматы аудио различаются в зависимости от провайдера. Распространенные форматы включают:

- `wav` - WAV аудио
- `mp3` - MP3 аудио
- `aiff` - AIFF аудио
- `aac` - AAC аудио
- `ogg` - OGG Vorbis аудио
- `flac` - FLAC аудио
- `m4a` - M4A аудио
- `pcm16` - PCM16 аудио
- `pcm24` - PCM24 аудио

**Примечание:** Проверьте документацию вашей модели, чтобы подтвердить, какие форматы аудио она поддерживает. Не все модели поддерживают все форматы.