Перейти к содержанию

POST /videos — создание задания генерации видео

POST /openrouter/api/v1/videos создает задание генерации видео для видеомоделей из списка медиамоделей. Поля запроса описаны в документации OpenRouter.

curl https://hub.coreinfra.ai/openrouter/api/v1/videos \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"google/veo-3.1","prompt":"Море"}'

Фрагмент ответа принятого задания:

{"status":"pending"}

Поле id из полного ответа используется для получения статуса и скачивания результата.

Отличия от API OpenRouter​

Поле user игнорируется, а callback_url не поддерживается: проверяйте состояние задания опросом GET /videos/{jobId}. В provider поддерживается только объект options; остальные поля игнорируются.

Изображения в frame_images и input_references передавайте в кодировке base64 (data:image/...;base64,...). Ссылки на внешние ресурсы отклоняются со статус-кодом 400.

Недоступная модель возвращает ошибку со статус-кодом 400. Поле previous_job_id может ссылаться только на задание той же модели, которое было создано с помощью того же ключа хаба.

polling_url, если он есть, содержит адрес проверки статуса через хаб. Элементы unsigned_urls содержат ссылки вида https://hub.coreinfra.ai/openrouter/api/v1/videos/{jobId}/content?index=N, где N — индекс результата с нуля. Подписанные ссылки в urls сохраняются.

При запуске задания средства резервируются. Отключение клиента не отменяет созданное задание. Правила оплаты — на странице «Стоимость видео».

Когда в usage переданы данные о стоимости и сумма списания рассчитана, хаб возвращает ее в рублях в поле usage.cost_rub; пока задание находится в статусе pending или in_progress (или если данные о стоимости в usage отсутствуют), usage.cost_rub не добавляется.

Ошибки​

Статус-кодУсловие
400Отсутствующая или недоступная для этого API метода модель
400Некорректный JSON или ссылка на внешний ресурс во входном изображении
400Задание в previous_job_id было создано другой моделью
404Задание не найдено или создано с другим ключом хаба
502Ошибка на стороне провайдера модели при создании задания

Ошибки ключа, баланса и лимитов описаны в общем справочнике, формат ошибок — в разделе API.