> ## 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 Q3 Pro: генерация видео из текста

Это асинхронный API, который возвращает только `task_id` асинхронной задачи.

<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="seed" type="integer">
  Случайное зерно для воспроизводимости результатов. Используйте 0 для случайного значения.

  Диапазон значений: \[0, 2147483647]
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  Использовать ли возможность прямого вывода аудио и видео (включая реплики и звуковые эффекты). Этот параметр поддерживается только моделями Q3.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Текстовое описание для генерации видео, максимум 2000 символов.

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

<ParamField body="wm_url" type="string">
  URL изображения водяного знака.
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Длительность видео (в секундах), диапазон 1-16.

  Диапазон значений: \[1, 16]
</ParamField>

<ParamField body="off_peak" type="boolean" default={false}>
  Использовать режим непиковой нагрузки. Задача будет обработана в течение 48 часов по более низкой стоимости.
</ParamField>

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

<ParamField body="resolution" type="string" default="720p">
  Качество выходного видео.

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

<ParamField body="wm_position" type="integer">
  Положение водяного знака: 1=слева сверху, 2=справа сверху, 3=слева снизу, 4=справа снизу.

  Диапазон значений: \[1, 4]
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Соотношение сторон выходного видео.

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

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

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