# Генерация видео

Source: https://provod.ai/ru/docs/video-generation

Создание видео начинается с `POST /v1/videos`. Подготовьте `API_BASE_URL` и `PROVOD_API_KEY`, как показано в [обзоре](/ru/docs/videos).

## Видео по тексту

Замените `MODEL_ID_FROM_CATALOG` точным ID доступной модели. Пример рассчитан на модель, которая принимает текст без обязательных референсов и поддерживает **5 секунд, 720p, 16:9**. Если каталог задаёт другие значения, измените их до отправки.

```bash
export VIDEO_MODEL="MODEL_ID_FROM_CATALOG"

jq -n --arg model "$VIDEO_MODEL" '{
  model: $model,
  prompt: "A slow camera pan across a quiet mountain lake at sunrise.",
  duration: 5,
  resolution: "720p",
  aspect_ratio: "16:9"
}' > video-request.json

curl --fail-with-body --silent --show-error \
  "$API_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @video-request.json -o video-job.json

jq '{id, status, polling_url}' video-job.json
```

Ответ `202` подтверждает создание задачи. Он не означает, что генерация уже завершилась. Сохраните `video-job.json` для [проверки результата](/ru/docs/video-jobs).

## Поля запроса

| Поле             | Назначение                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------ |
| `model`          | Обязательный публичный ID модели                                                           |
| `prompt`         | Описание сцены, до 8 000 символов; требования модели могут быть строже                     |
| `duration`       | Целое число секунд от 1 до 120, дополнительно ограниченное моделью                         |
| `resolution`     | Значение из каталога, например `720p`                                                      |
| `size`           | Размер вида `1280x720`, если поддерживается                                                |
| `aspect_ratio`   | Соотношение сторон, например `16:9`                                                        |
| `generate_audio` | Генерация звука, если поддерживается                                                       |
| `seed`           | Целое число от 0 до 2 147 483 647, если поддерживается; не гарантия одинакового результата |
| `callback_url`   | Публичный HTTPS-адрес для уведомления о результате                                         |

## Первый и последний кадр

Добавьте `frame_images` к основному запросу. `first_frame` и `last_frame` допустимы только при поддержке выбранной моделью.

```json
{
  "frame_images": [
    {
      "type": "image_url",
      "frame_type": "first_frame",
      "image_url": {"url": "https://media.example.com/first-frame.jpg"}
    }
  ]
}
```

Замените пример URL действительной ссылкой. Ограничения `input_constraints.image` распространяются и на кадры.

## Изображения, аудио и видео как референсы

`input_references` содержит объекты с типом и вложенным URL. Ниже показана форма трёх типов; оставьте только необходимые и поддерживаемые выбранной моделью элементы.

```json
{
  "input_references": [
    {"type": "image_url", "image_url": {"url": "https://media.example.com/reference.jpg"}},
    {"type": "audio_url", "audio_url": {"url": "https://media.example.com/reference.mp3"}},
    {"type": "video_url", "video_url": {"url": "https://media.example.com/reference.mp4"}}
  ]
}
```

Каждый тип из `required_input_reference_types` должен присутствовать. Учитывайте ограничения длительности, размера, MIME-типа и количества файлов. Если `reference_audio_requires_visual_input` включён, к аудио нужен визуальный материал; также проверяйте `maximum_reference_audio_duration_seconds`.

Для API используйте доступные поставщику HTTPS-ссылки без cookies и заголовка авторизации. Локальный путь на вашем компьютере не подходит. Срок жизни временной ссылки должен покрывать очередь и обработку задачи. Загрузка файлов в кабинете — отдельный интерфейс с авторизацией сессией; публичной multipart-ручки `/v1/videos/input-assets` нет.

## Звук и дополнительные параметры

`generate_audio=true` запрашивает генерацию звука. Наличие аудиореференса само по себе не подтверждает сохранение исходной речи, voice cloning или lip-sync. Используйте такой режим только при подтверждённом контракте конкретной модели; универсальной гарантии для всех видеомоделей нет.

`allowed_passthrough_parameters` перечисляет дополнительные разрешённые поля. Не переносите поля вроде корневого `audio` из API другого сервиса без проверки нашего контракта. `provider` и дополнительные настройки тоже зависят от поддерживаемого маршрута.

## Если создание не удалось

При ошибке валидации проверьте поля и допустимое сочетание в каталоге. При обрыве HTTP после отправки не повторяйте создание автоматически: задача уже могла появиться. Публичного контракта идемпотентности для `POST /v1/videos` нет; повтор может создать и оплатить ещё одну генерацию.

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


**Запрос отклонён**


Сверьте обязательные референсы и ограничения файлов с каталогом. Отправляйте только поддерживаемые сочетания параметров.
