Видео

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

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

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

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

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

Сначала получите стоимость через POST /v1/quotes с operation=video_generation. Длительность и разрешение задаются в settings и только в пределах карточки модели; лишняя настройка отклоняется до резерва. Цена видео бывает за запрос или за секунду и может зависеть от разрешения: оценка учитывает выбранные настройки.

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

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

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

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