# Видео API

Source: https://provod.ai/ru/docs/videos

*Создание видео и получение результата*

Видео генерируется фоновой задачей. `POST /v1/videos` возвращает `202` и ID задачи; готовый файл получают отдельным запросом.

| Шаг                                        | Ручка                                 | Результат                |
| ------------------------------------------ | ------------------------------------- | ------------------------ |
| Выбрать модель                             | `GET /v1/videos/models`               | Каталог параметров и цен |
| [Создать видео](/ru/docs/video-generation) | `POST /v1/videos`                     | ID и `polling_url`       |
| [Проверить задачу](/ru/docs/video-jobs)    | `GET /v1/videos/{id}`                 | Статус и результат       |
| Скачать файл                               | `GET /v1/videos/{id}/content?index=0` | Байты видео              |

Используйте [API-ключ рабочего пространства](/ru/docs/authentication). Ручки доступны также с префиксом `/api/v1/videos`. Не добавляйте `/v1` дважды.

## Выбор модели

```bash
export API_BASE_URL="https://api.provod.ai"
export PROVOD_API_KEY="YOUR_API_KEY"

curl --fail-with-body --silent --show-error \
  "$API_BASE_URL/v1/videos/models" \
  -H "Authorization: Bearer $PROVOD_API_KEY" -o video-models.json

jq '.data[] | {id, available, supported_durations, supported_resolutions,
  supported_aspect_ratios, required_input_reference_types, currency,
  minimum_price_per_second}' video-models.json
```

В `model` передавайте точный `id`. Для поиска в общем каталоге также есть `GET /api/models?kind=video`; примеры этой страницы используют специализированный `/v1/videos/models` и его названия полей.

Проверяйте `available` и `unavailable_reason`, затем ограничения выбранной модели:

* `supported_durations`, `supported_resolutions`, `supported_sizes`, `supported_aspect_ratios` — параметры результата;
* `supported_frame_images` — поддержка первого и последнего кадра;
* `supported_input_reference_types` и `required_input_reference_types` — допустимые и обязательные исходные материалы;
* `input_constraints` — известные ограничения файлов;
* `generate_audio` и `seed` — поддержка соответствующих настроек.

`null` или отсутствующая граница не означают отсутствие ограничений. Наличие отдельных значений в каталоге не гарантирует совместимость всех их сочетаний. Доступность модели также не гарантирует успешный ответ на любой запрос.

## Стоимость и баланс

`currency` задаёт валюту каталога. `minimum_price_per_second` — минимальная оценка за секунду, а не точная цена любого режима. Итог зависит от модели и выбранного варианта, включая разрешение и звук. Не умножайте минимальную цену на длительность как гарантированную стоимость.

При создании задачи сумма резервируется; после успешного завершения списание выполняется по сохранённому тарифу. При окончательной ошибке резерв освобождается. Пока задача выполняется или повторяется внутри сервиса, резерв может оставаться активным. Итог проверяйте в [расходах](/ru/docs/usage-costs).

В публичном ответе `usage.cost`, когда он присутствует, выражен в USD. Это не сумма в рублях. Для provod.ai фактические рублёвые списания отражены в истории баланса. `usage.is_byok` равен `false`.

Публичной ручки расчёта точной цены с API-ключом сейчас нет. Оценка в кабинете относится к его авторизованному интерфейсу и не является `/v1/videos/quote`.

## С чего начать

Выберите модель без обязательных исходных материалов и создайте [видео по тексту](/ru/docs/video-generation). Затем сохраните ID и настройте [опрос статуса или webhook](/ru/docs/video-jobs).

## Решение проблем


**Модель недоступна**


Обновите каталог и проверьте `available`, `unavailable_reason` и точный ID модели. Не подставляйте ID из текстового каталога.
