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.
