API
Запустить обработку медиафайла
Создать новую задачу для транскрибации, диаризации и генерации саммари из аудио- или видеофайла
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): Схема ответа для шага summarizationoptions(object): Дополнительные опции для шага
Примеры запросов
Базовый пример
Расширенный пример
Ответы
201 - Задача успешно создана
200 - Результат обработки (синхронный режим)
400 - Некорректный запрос
Возвращается при неверных параметрах запроса или отсутствии обязательных полей.Примечания
- Необходимо указать либо
url, либоfileUrlс прямой ссылки на медиафайл - Ссылки на медиатеки (Rutube, Youtube и подобные), или облачные диски (Google Drive, Yandex disk и подобные) не поддерживаются
- Можно использовать либо
webhookUrl, либоwebhook_urlдля URL обратного вызова - Поддерживаются все форматы аудио и видео файлов
- При указании
send_intermediate_webhooks: trueбудут отправляться уведомления о завершении каждого этапа обработки - Результат может быть получен как через webhook, так и через запрос статуса задачи методом GET по полученному
taskId
Запустить обработку медиафайла