Skip to main content
POST
https://stiltedly-viable-akita.cloudpub.ru/api
/
v1
/
summarization
Запустить саммаризацию
curl --request POST \
  --url https://stiltedly-viable-akita.cloudpub.ru/api/v1/summarization \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "<string>",
  "sourceUri": "<string>",
  "languageOut": "<string>",
  "template": "<string>",
  "prompt": "<string>",
  "responseSchema": {},
  "filename": "<string>",
  "webhookUrl": "<string>"
}
'
{
  "id": "<string>",
  "url": "<string>",
  "synopsis": "<string>",
  "transcript": {},
  "transcriptDiarized": {},
  "transcriptDepersonalized": {},
  "filename": "<string>"
}
Этот метод позволяет создать саммари непосредственно из текста (или уже созданного транскрипта) без необходимости обработки аудио/видео файлов.

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

​
Входные данные

​
input
string
required
Текст для генерации саммари
​
sourceUri
string
URI источника текста или ID завершенной задачи, которая будет использована как источник данных для новой задачи

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

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

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

​
template
string
Название шаблона для использования в LLM при генерации саммари (например: “meeting”)
​
prompt
string
required
Кастомный промт для LLM для генерации саммари
​
responseSchema
object
Схема ответа для формата результата, определяющая структуру выходного саммари

​
Дополнительные настройки

​
filename
string
Имя файла для сохранения результата
​
webhookUrl
string
URL для отправки результатов, когда они будут готовы

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

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

{
  "input": "Это длинный текст встречи, который содержит множество обсуждений по различным вопросам. Участники обсудили бюджет на следующий квартал, планы по расширению команды и новые продуктовые инициативы...",
  "languageIn": "ru",
  "languageOut": "ru",
  "template": "meeting"
}

​
Пример с кастомным промптом

{
  "input": "Текст для обработки...",
  "prompt": "Выдели ключевые моменты из этого текста и представь их в виде списка действий",
  "languageIn": "en",
  "languageOut": "ru",
  "filename": "summary_result.txt"
}

​
Пример с использованием завершенной задачи

{
  "sourceUri": "task-1d2f3a4b-5c6d-7e8f-9g0h-1i2j3k4l5m6n",
  "template": "detailed_analysis",
  "languageOut": "en",
  "webhookUrl": "https://example.com/webhook",
  "responseSchema": {
    "type": "object",
    "properties": {
      "summary": {"type": "string"},
      "key_points": {"type": "array"},
      "action_items": {"type": "array"}
    }
  }
}

​
Ответы

​
200 - Успешное выполнение операции

{
  "id": "2e3f4a5b-6c7d-8e9f-0g1h-2i3j4k5l6m7n",
  "url": "",
  "synopsis": "Ключевые моменты обсуждения:\n1. Утверждение бюджета на Q4\n2. Планы найма 3 новых разработчиков\n3. Запуск бета-версии продукта в декабре",
  "transcript": {
    "text": "Исходный текст для саммаризации..."
  },
  "filename": "summary_result.txt"
}

​
Поля ответа

​
id
string
required
Уникальный идентификатор задачи саммаризации
​
url
string
URL исходного контента (может быть пустым для текстовых задач)
​
synopsis
string
Сгенерированное краткое содержание (саммари) текста
​
transcript
object
Исходный текст для саммаризации (если включен в ответ)
​
transcriptDiarized
object
Диаризированный текст (если применимо к источнику)
​
transcriptDepersonalized
object
Деперсонализированный текст (если применимо)
​
filename
string
Имя файла результата (если указано)

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

{
  "error": "Bad Request",
  "message": "Необходимо указать либо 'input', либо 'sourceUri'"
}

​
500 - Ошибка сервера

{
  "error": "Internal Server Error",
  "message": "Ошибка при генерации саммари"
}

​
Примечания

  • Необходимо указать либо input (прямой текст), либо sourceUri (ссылка на завершенную задачу)
  • При использовании sourceUri система автоматически извлечет текст из указанной задачи
  • Параметр responseSchema позволяет задать структурированный формат выходного саммари
  • Если указан webhookUrl, результат будет отправлен асинхронно
  • Поддерживается перевод саммари на другой язык через параметрlanguageOut