Загрузка...
Аудио

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

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

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

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

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

Запросы с аудиофайлами к совместимым моделям доступны через API /api/v1/chat/completions с типом контента input_audio. Аудиофайлы должны быть закодированы в base64 и включать спецификацию формата. Обратите внимание, что только модели с возможностями обработки аудио будут обрабатывать эти запросы.

Вы можете найти модели с поддержкой аудио, отфильтровав по модальности аудио входа на нашей странице моделей.

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

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

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

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

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

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 аудио

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