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

Изменения запроса, владение заданием и резерв средств при генерации видео через хаб.

`POST /openrouter/api/v1/videos` создает задание генерации видео для видеомоделей из [списка медиамоделей](https://coreinfra.ru/docs/reference/openrouter/models.md). Поля запроса описаны в [документации OpenRouter](https://openrouter.ai/docs/api/api-reference/video-generation/submit-a-video-generation-request).

```bash
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":"Море"}'
```

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

```json
{"status":"pending"}
```

Поле `id` из полного ответа используется для [получения статуса](https://coreinfra.ru/docs/reference/openrouter/videos-job.md) и [скачивания результата](https://coreinfra.ru/docs/reference/openrouter/videos-content.md).

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

Поле `user` игнорируется, а `callback_url` не поддерживается: проверяйте состояние задания опросом [`GET /videos/{jobId}`](https://coreinfra.ru/docs/reference/openrouter/videos-job.md). В `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` сохраняются.

При запуске задания средства резервируются. Отключение клиента не отменяет созданное задание. Правила оплаты — на странице [«Стоимость видео»](https://coreinfra.ru/docs/video-billing.md).

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

## Ошибки

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

Ошибки ключа, баланса и лимитов описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors), формат ошибок — в [разделе API](https://coreinfra.ru/docs/reference/openrouter.md#errors).
