> ## 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="url" type="string" required>
  Прямая ссылка на аудио/видео файл для обработки (альтернатива fileUrl)
</ParamField>

<ParamField body="fileUrl" type="string" deprecated>
  Ссылка на аудио/видео файл для обработки (альтернатива url)
</ParamField>

<ParamField body="webhookUrl" type="string" deprecated>
  URL для отправки результатов обработки (альтернатива webhook\_url)
</ParamField>

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

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

<ParamField body="transcript_n" type="boolean">
  Включить транскрипцию в конечный результат (job и webhook)
</ParamField>

<ParamField body="summary_n" type="boolean">
  Включить саммари в конечный результат (job и webhook)
</ParamField>

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

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

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

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

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

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

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

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

<ParamField body="input" type="string">
  Входные данные для аудио файла или текстового ввода
</ParamField>

<ParamField body="send_intermediate_webhooks" type="boolean">
  Отправлять webhooks при завершении промежуточных шагов обработки
</ParamField>

<ParamField body="steps" type="array">
  Список шагов обработки. Каждый элемент содержит:

  * `name` (string): Тип шага
  * `dependsOn` (array): Массив шагов, от которых зависит текущий шаг
  * `responseSchema` (object): Схема ответа для шага summarization
  * `options` (object): Дополнительные опции для шага
</ParamField>

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

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

```json theme={null}
{
  "url": "https://example.com/input.mp3"
}
```

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

```json theme={null}
{
  "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 - Задача успешно создана

```json theme={null}
{
  "taskId": "1d2f3a4b-5c6d-7e8f-9g0h-1i2j3k4l5m6n"
}
```

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

```json theme={null}
{
  "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`