Skip to main content
POST
Запустить обработку медиафайла
Этот метод позволяет отправить медиафайл на обработку и получить транскрипт, диаризацию (разделение по говорящим) и автоматически сгенерированное саммари.

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

Основные параметры

string
required
Прямая ссылка на аудио/видео файл для обработки (альтернатива fileUrl)
string
deprecated
Ссылка на аудио/видео файл для обработки (альтернатива url)
string
deprecated
URL для отправки результатов обработки (альтернатива webhook_url)
string
URL для отправки результатов обработки (альтернатива webhookUrl)

Настройки вывода

boolean
Включить транскрипцию в конечный результат (job и webhook)
boolean
Включить саммари в конечный результат (job и webhook)
string
Имя файла для отправки в webhook и выходной результат

Языковые настройки

string
Язык входного аудио в формате ISO 639-1 (например: “ru”, “en”, “de”)
string
Язык выходного саммари в формате ISO 639-1 (например: “ru”, “en”, “de”)

Настройки AI и генерации

string
Название шаблона для использования в LLM при генерации саммари (например: “meeting”)
string
Кастомный промт для LLM для генерации саммари

Расширенные настройки

string
Входные данные для аудио файла или текстового ввода
boolean
Отправлять webhooks при завершении промежуточных шагов обработки
array
Список шагов обработки. Каждый элемент содержит:
  • name (string): Тип шага
  • dependsOn (array): Массив шагов, от которых зависит текущий шаг
  • responseSchema (object): Схема ответа для шага summarization
  • options (object): Дополнительные опции для шага

Примеры запросов

Базовый пример

Расширенный пример

Ответы

201 - Задача успешно создана

200 - Результат обработки (синхронный режим)

400 - Некорректный запрос

Возвращается при неверных параметрах запроса или отсутствии обязательных полей.

Примечания

  • Необходимо указать либо url, либо fileUrl с прямой ссылки на медиафайл
  • Ссылки на медиатеки (Rutube, Youtube и подобные), или облачные диски (Google Drive, Yandex disk и подобные) не поддерживаются
  • Можно использовать либо webhookUrl, либо webhook_url для URL обратного вызова
  • Поддерживаются все форматы аудио и видео файлов
  • При указании send_intermediate_webhooks: true будут отправляться уведомления о завершении каждого этапа обработки
  • Результат может быть получен как через webhook, так и через запрос статуса задачи методом GET по полученному taskId