Skip to main content
POST
https://stiltedly-viable-akita.cloudpub.ru/api
/
v1
/
prediction
Запустить обработку медиафайла
curl --request POST \
  --url https://stiltedly-viable-akita.cloudpub.ru/api/v1/prediction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "fileUrl": "<string>",
  "webhookUrl": "<string>",
  "webhook_url": "<string>",
  "transcript_n": true,
  "summary_n": true,
  "filename": "<string>",
  "language_in": "<string>",
  "language_out": "<string>",
  "template": "<string>",
  "prompt": "<string>",
  "input": "<string>",
  "send_intermediate_webhooks": true,
  "steps": [
    {}
  ]
}
'
Этот метод позволяет отправить медиафайл на обработку и получить транскрипт, диаризацию (разделение по говорящим) и автоматически сгенерированное саммари.

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "url": "https://example.com/input.mp3"
}

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

{
  "fileUrl": "https://example.com/input.mp3",
  "webhookUrl": "https://example.com/webhook",
  "transcript_n": true,
  "summary_n": true,
  "language_in": "en",
  "language_out": "ru",
  "template": "meeting",
  "filename": "Очень важная встреча",
  "send_intermediate_webhooks": true
}

​
Ответы

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

{
  "taskId": "1d2f3a4b-5c6d-7e8f-9g0h-1i2j3k4l5m6n"
}

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

{
  "id": "string",
  "url": "string",
  "audioLengthMinutes": 18,
  "synopsis": "string",
  "transcript": {},
  "transcriptDiarized": {},
  "transcriptDepersonalized": {},
  "filename": "string"
}

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

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

​
Примечания

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