> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Шаблон сцен VIDU Q2

Генерирует видео со спецэффектами на основе шаблона сцены и входного изображения. Поддерживает различные шаблоны сцен; разные шаблоны поддерживают разные параметры спецэффектов.

<Tip>
  Это **асинхронный** API, который возвращает только task\_id асинхронной задачи. Используйте этот task\_id для запроса [API получения результата задачи](/ru/docs/models/reference-get-async-task-result), чтобы получить результат генерации.
</Tip>

## Заголовки запроса

<ParamField header="Content-Type" type="string" required={true}>
  Перечисляемое значение: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Формат Bearer-аутентификации: Bearer \{\{API 密钥}}.
</ParamField>

## Тело запроса

<ParamField body="bgm" type="boolean" default={false}>
  Нужно ли добавлять фоновую музыку к сгенерированному видео. По умолчанию: false. При передаче true система автоматически выберет подходящую музыку из предустановленной библиотеки BGM и добавит ее; если параметр не передан или имеет значение false, BGM не добавляется. Продолжительность BGM не ограничена, система автоматически адаптирует ее к продолжительности видео
</ParamField>

<ParamField body="area" type="string" default="auto">
  Специальный параметр для эффекта «экзотическая принцесса». Доступен только когда template передан как exotic\_princess. По умолчанию: auto

  Допустимые значения: `auto`, `denmark`, `uk`, `africa`, `china`, `mexico`, `switzerland`, `russia`, `italy`, `korea`, `thailand`, `india`, `japan`
</ParamField>

<ParamField body="seed" type="integer" default={0}>
  Случайное зерно. Если параметр по умолчанию не передан или передано 0, вместо него будет использовано случайное число; при ручной настройке используется заданное зерно
</ParamField>

<ParamField body="beast" type="string" default="auto">
  Специальный параметр для эффекта «спутник-зверь». Доступен только когда template передан как beast\_companion. По умолчанию: auto

  Допустимые значения: `auto`, `bear`, `tiger`, `elk`, `snake`, `lion`, `wolf`
</ParamField>

<ParamField body="images" type="string[]" required={true}>
  Список входных изображений. Модель будет генерировать видео на основе изображений, переданных в этом параметре. Поддерживается передача изображений в кодировке Base64 или URL изображения (убедитесь, что он доступен). Поддерживаемые форматы изображений: png, jpeg, jpg, webp. Соотношение сторон изображения должно быть меньше 1:4 или 4:1, размер — не более 50MB. Длина в байтах после декодирования Base64 должна быть менее 10M, а кодировка должна содержать соответствующую строку типа содержимого, например: `data:image/png;base64,{base64_encode}`

  Длина массива: 1 — без ограничений
</ParamField>

<ParamField body="prompt" type="string">
  Текстовый промпт, текстовое описание для генерации видео. Примечание: когда template=subject\_3, pubg\_winner\_hit, промпт не является обязательным
</ParamField>

<ParamField body="wm_url" type="string">
  Содержимое водяного знака, здесь — URL изображения. Если не передано, используется водяной знак по умолчанию: контент сгенерирован AI
</ParamField>

<ParamField body="payload" type="string">
  Сквозной параметр, не обрабатывается, используется только для передачи данных. Максимум 1048576 символов

  Ограничение длины: 0 - 1048576
</ParamField>

<ParamField body="template" type="string" required={true}>
  Параметр шаблона сцены. Разные шаблоны сцен соответствуют разным параметрам вызова. Распространенные шаблоны: subject\_3 (смена наряда персонажа), pubg\_winner\_hit (эффект «победитель PUBG»), exotic\_princess (экзотическая принцесса), beast\_companion (спутник-зверь) и т. д. Конкретные шаблоны см. здесь: [https://platform.vidu.cn/docs/templates](https://platform.vidu.cn/docs/templates)
</ParamField>

<ParamField body="meta_data" type="string">
  Идентификатор метаданных, строка в формате json, сквозное поле. Вы можете определить собственный формат или использовать формат примера. Если этот параметр пуст, по умолчанию используется идентификатор метаданных, сгенерированный vidu. Формат примера: `{"Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2"}`
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Нужно ли добавлять водяной знак. true: добавить водяной знак; false: не добавлять водяной знак. В настоящее время содержимое водяного знака фиксировано: контент сгенерирован AI; по умолчанию не добавляется. Вы можете получить видео с водяным знаком, запросив параметр watermarked\_url
</ParamField>

<ParamField body="wm_position" type="integer" default={3}>
  Положение водяного знака, указывает место появления водяного знака на изображении. 1: верхний левый угол; 2: верхний правый угол; 3: нижний правый угол; 4: нижний левый угол. По умолчанию — 3

  Допустимые значения: `1`, `2`, `3`, `4`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Соотношение сторон видео. По умолчанию 16:9, доступные значения: 16:9, 9:16. Разные template поддерживают разные доступные значения; подробности см. в описании шаблона

  Допустимые значения: `16:9`, `9:16`
</ParamField>

## Информация об ответе

<ResponseField name="task_id" type="string" required={true}>
  Используйте task\_id для запроса [API получения результата задачи](/ru/docs/models/reference-get-async-task-result), чтобы получить сгенерированный вывод.
</ResponseField>

<ResponseField name="provider_request_id" type="string" required={false}>
  ID запроса провайдера (необязательно)
</ResponseField>