Видео через API: оценка, задание и приватный файл
Как пройти асинхронный путь и восстановить результат по ID без повторного создания генерации.
Что проверено. Сверка с опубликованным контрактом Kvantora. Платный вызов модели в рамках этой проверки не выполнялся.
Тариф, параметры и доступность зависят от операции. Реальная генерация видео не выполнялась; наличие карточки не означает доступный запуск.
Оцените тот набор параметров, который отправите
В карточке модели выберите операцию video_generation и проверьте разрешённый запуск. Передайте параметры в /v1/quotes вместе с operation. Оценка не создаёт задание и не резервирует деньги.
Цена должна относиться к выбранным параметрам. Нельзя взять минимальную цифру из каталога, а затем отправить другой режим. Если параметр не входит в поддержанный контракт операции, интерфейс и API должны явно отклонить его, а не незаметно проигнорировать.
{
"model": "PUBLIC_API_ID",
"operation": "video_generation",
"prompt": "Синтетический тест: спокойный пролёт над вымышленным озером."
}После отправки сохраняйте ID задания
Создание видео выполняется через POST /v1/videos с отдельным Idempotency-Key и max_cost_microrub. В ответе находится задание. HTTP 202 означает приём обработки, а не готовый ролик.
Сохраняйте ID и проверяйте GET /v1/jobs/ID. Состояние unknown требует ожидания сверки. Не запускайте новую генерацию только потому, что закончился таймаут браузера. Отмена безопасна лишь в разрешённом сервером состоянии; отказ cancellation_not_safe нельзя скрывать.
- Получить оценку и проверить expires_at.
- Сохранить тело и Idempotency-Key.
- Создать одно задание.
- Опросить сохранённый ID до завершения.
- После succeeded получить output.file_id и ссылку на скачивание.
Ссылка и сам файл имеют сроки
Результат скачивается через GET /v1/files/ID/download с правами владельца. Подписанная ссылка временна; её истечение не означает, что нужно снова генерировать видео. Пока сам файл существует, получите новую разрешённую ссылку.
После истечения срока хранения сервер может вернуть file_expired. Не обещайте постоянное хранение по старой ссылке и не размещайте URL чужого файла в публичном журнале. Проверьте, что другая организация и отозванный ключ не получают результат.
Источники и повторная проверка
При изменении API-контракта, доступных параметров, тарифа или версии клиента пример нужно проверить повторно. Редакционная правка сама по себе не подтверждает новый технический тест.