> ## 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 Pro Fast: видео по референсу

API VIDU Q2 Pro Fast для преобразования референсного изображения/видео в видео. Поддерживаются режим с субъектом и режим без субъекта, а также два разрешения: 720p и 1080p.

<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}>
  Добавлять ли фоновую музыку
</ParamField>

<ParamField body="seed" type="integer">
  Случайное зерно, используемое для управления случайностью результата генерации. Одинаковое зерно дает похожие результаты.
</ParamField>

<ParamField body="audio" type="boolean" default={false}>
  Генерировать ли аудио
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Текстовый промпт; можно использовать заполнители @1, @2 и т. д. для ссылки на субъект

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

<ParamField body="duration" type="integer" required={true} default={5}>
  Длительность видео (в секундах), поддерживается 1–10 секунд

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

<ParamField body="subjects" type="object[]" required={true}>
  Список субъектов; каждый субъект содержит name, images и voice\_id

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

  <Expandable title="свойства" defaultOpen={true}>
    <ParamField body="name" type="string" required={true}>
      Имя субъекта; используйте @{name} в prompt для ссылки
    </ParamField>

    <ParamField body="images" type="string[]">
      Список URL изображений субъекта: максимум 3 изображения, каждое не более 20MB

      Длина массива: 0 - 3
    </ParamField>

    <ParamField body="voice_id" type="string">
      ID голоса, необязательно
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Добавлять ли водяной знак
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Разрешение выходного видео. Значение по умолчанию — 720p.

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

<ParamField body="aspect_ratio" type="string">
  Соотношение сторон видео, например 16:9, 9:16, 1:1 и т. д.
</ParamField>

<ParamField body="movement_amplitude" type="string">
  Амплитуда движения, управляющая интенсивностью движения объектов в видео

  Допустимые значения: `auto`, `small`, `medium`, `high`
</ParamField>

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

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