> ## 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.

# Wanxiang Wan 2.7: видео по референсу

Модель Wanxiang Wan 2.7 для генерации видео по референсу поддерживает мультимодальный ввод (текст/изображения/видео) и позволяет использовать человека или объект в качестве главного героя для создания видео с выступлением одного персонажа или взаимодействием нескольких персонажей. Поддерживает интеллектуальную раскадровку и генерацию видео с несколькими планами. Поддерживаются разрешения 720P и 1080P, длительность от 2 до 10 секунд, тарификация посекундная. По умолчанию результат содержит аудио.

<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, 2147483647].

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

<ParamField body="size" type="string" default="1920*1080">
  Разрешение выходного видео (ширина*высота), влияет на стоимость. Уровень 720P: 1280*720 (16:9), 720*1280 (9:16), 960*960 (1:1), 1088*832 (4:3), 832*1088 (3:4). Уровень 1080P: 1920*1080 (16:9), 1080*1920 (9:16), 1440*1440 (1:1), 1632*1248 (4:3), 1248\*1632 (3:4).

  Допустимые значения: `1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088`, `1920*1080`, `1080*1920`, `1440*1440`, `1632*1248`, `1248*1632`
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  Генерировать ли видео со звуком; влияет на стоимость. По умолчанию true (видео со звуком).
</ParamField>

<ParamField body="media" type="object[]" required={true}>
  Массив референсных медиафайлов, используемый для извлечения внешности персонажа, движений и тембра голоса. В порядке массива соответствует character1, character2 и т. д. в prompt. Количество изображений: 0–5, количество видео: 0–3, общее количество — не более 5. Форматы изображений: JPEG, JPG, PNG, BMP, WEBP; разрешение \[240,8000] пикселей, размер не более 10 MB. Форматы видео: MP4, MOV; длительность 1–30 секунд, размер не более 100 MB. Форматы аудио: MP3, WAV, FLAC; длительность 3–30 секунд.

  Длина массива: 1 - 5

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="url" type="string" required={true}>
      URL медиафайла.
    </ParamField>

    <ParamField body="type" type="string" required={true}>
      Тип медиа. reference\_image: референсное изображение для извлечения внешности персонажа; reference\_video: референсное видео для извлечения движений и внешности персонажа; first\_frame: изображение первого кадра для управления начальным кадром видео.

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

    <ParamField body="reference_voice" type="string">
      URL референсного аудио персонажа, используемый для клонирования тембра голоса персонажа и генерации видео со звуком. Форматы: MP3, WAV, FLAC; длительность 3–30 секунд.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Текстовый промпт, описывающий элементы и визуальные характеристики, которые должны присутствовать в генерируемом видео. Используйте идентификаторы character1, character2 и т. д. для ссылки на референсных персонажей; каждый референс (видео или изображение) должен содержать только одного персонажа. Поддерживаются китайский и английский языки, максимум 1500 символов.

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

<ParamField body="duration" type="integer" default={5}>
  Длительность генерируемого видео в секундах; тарификация посекундная. Целое число в диапазоне \[2, 10].

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

<ParamField body="shot_type" type="string" default="single">
  Тип плана. single — один план (по умолчанию), multi — несколько планов. Этот параметр имеет более высокий приоритет, чем prompt.

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

<ParamField body="watermark" type="boolean" default={false}>
  Добавлять ли водяной знак; водяной знак располагается в правом нижнем углу видео.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Негативный промпт, описывающий содержимое, которое не должно появляться в кадрах видео. Поддерживаются китайский и английский языки, максимум 500 символов.

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

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

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