API транскрипции аудио

Преобразуйте аудиофайлы в текст с помощью возможностей транскрипции на базе ИИ.

Эндпоинт

POST https://filebrain.pro/api/audio/transcriber/v1/

Требования к файлам

Типы файлов

  • MP3
  • WAV
  • M4A

Ограничения

  • Максимальный размер файла: 25MB
  • Один аудиофайл на запрос

Параметры запроса

Параметр Тип Обязательный Описание
audio file Да Аудиофайл для транскрипции
api_key string Да Ваш API ключ FileBrain
llm_api_key string Да Ваш API ключ LLM (поддерживается OpenAI)
language string Нет ISO код языка (например, 'en'). Автоопределение, если не указан

Пример кода

Пример на Python
import requests

def transcribe_audio(audio_path, api_key, llm_api_key, language=None):
    # Подготавливаем файлы и данные
    files = {
        'audio': ('audio.mp3', open(audio_path, 'rb'), 'audio/mpeg')
    }
    
    data = {
        'api_key': api_key,
        'llm_api_key': llm_api_key
    }

    # Добавляем язык, если указан
    if language:
        data['language'] = language

    # Выполняем запрос
    response = requests.post(
        'https://filebrain.pro/api/audio/transcriber/v1/',
        files=files,
        data=data
    )
    
    # Проверяем ответ
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"Ошибка: {response.status_code}, {response.text}")

# Пример использования
result = transcribe_audio(
    'path/to/audio.mp3',
    'YOUR_FBP_ACCOUNT_API_KEY',
    'YOUR_OPENAI_API_KEY',
    language='en'  # Опционально
)

Формат ответа

Успешный ответ (200 OK)
{
    "status": "success",
    "message": {
        "transcription": "Транскрибированный текстовый контент...",
        "language": "en"
    }
}

Обработка ошибок

Распространенные коды ошибок

  • 400 - Неверный запрос (отсутствующие параметры, неверный тип файла)
  • 401 - Неверный API ключ
  • 413 - Файл слишком большой (>25MB)
  • 429 - Превышен лимит запросов
  • 500 - Ошибка сервера