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

# Видео

> Создать видео, дождаться задания и получить приватный файл.

## Подготовьте запрос

`POST /v1/videos` принимает `model`, `prompt` и необязательный `max_cost_microrub`. Ответ 202 содержит ID задания. Получение результата: `GET /v1/jobs/ID`, затем `GET /v1/files/FILE_ID/download`.

Используйте публичный ID из [каталога](/models), ключ с разрешённой видеооперацией и сохранённый `Idempotency-Key`. Пример тела:

```javascript theme={null}
const requestBody = {
  model: process.env.KVANTORA_MODEL_ID,
  prompt: 'Камера медленно движется вдоль берега озера',
};
```

## Оцените стоимость

Сначала получите фиксированную стоимость через POST /v1/quotes с operation=video\_generation. Длительность, FPS, разрешение и оплата по секундам в текущий контракт не входят.

Для своего лимита используйте перевод рублей в `max_cost_microrub` из [руководства по оплате](/billing). В запрос оценки передайте то же тело и `operation: video_generation`; в запрос генерации поле `operation` не добавляйте.

## Получите файл

Сохраните ID из ответа. Когда статус задания станет `succeeded`, возьмите `output.file_id` и запросите приватный файл с тем же ключом. Для чтения нужны права на задания и файлы. [Статусы и отмена](/jobs) · [Получение файлов](/files).

Сервис продолжает проверять уже созданное задание после перезапуска, не запуская новую генерацию. Если ответ на отправку потерян, резерв сохраняется до выяснения результата.
