> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synopsisai.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Запустить саммаризацию

> Запустить задачу по саммаризации произвольного текста, текстового файла или транскрипта

Этот метод позволяет создать саммари непосредственно из текста (или уже созданного транскрипта) без необходимости обработки аудио/видео файлов.

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

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

<ParamField body="input" type="string" required>
  Текст для генерации саммари
</ParamField>

<ParamField body="sourceUri" type="string">
  URI источника текста или ID завершенной задачи, которая будет использована как источник данных для новой задачи
</ParamField>

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

<ParamField body="languageOut" default="ru" type="string">
  Язык выходного саммари в формате ISO 639-1 (например: "ru", "en", "de")
</ParamField>

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

<ParamField body="template" type="string">
  Название шаблона для использования в LLM при генерации саммари (например: "meeting")
</ParamField>

<ParamField body="prompt" type="string" required>
  Кастомный промт для LLM для генерации саммари
</ParamField>

<ParamField body="responseSchema" type="object">
  Схема ответа для формата результата, определяющая структуру выходного саммари
</ParamField>

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

<ParamField body="filename" type="string">
  Имя файла для сохранения результата
</ParamField>

<ParamField body="webhookUrl" type="string">
  URL для отправки результатов, когда они будут готовы
</ParamField>

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

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

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

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

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

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

```json theme={null}
{
  "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 - Успешное выполнение операции

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

### Поля ответа

<ResponseField name="id" type="string" required>
  Уникальный идентификатор задачи саммаризации
</ResponseField>

<ResponseField name="url" type="string">
  URL исходного контента (может быть пустым для текстовых задач)
</ResponseField>

<ResponseField name="synopsis" type="string">
  Сгенерированное краткое содержание (саммари) текста
</ResponseField>

<ResponseField name="transcript" type="object">
  Исходный текст для саммаризации (если включен в ответ)
</ResponseField>

<ResponseField name="transcriptDiarized" type="object">
  Диаризированный текст (если применимо к источнику)
</ResponseField>

<ResponseField name="transcriptDepersonalized" type="object">
  Деперсонализированный текст (если применимо)
</ResponseField>

<ResponseField name="filename" type="string">
  Имя файла результата (если указано)
</ResponseField>

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

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

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

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

## Примечания

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