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

# Pixverse C1: генерация видео по референсным изображениям

Инструмент Pixverse C1 для генерации видео по референсным изображениям создает кинематографические видео на основе 1–7 референсных изображений. Он позволяет ссылаться на референсы в промпте с помощью синтаксиса @ref\_name, поддерживает согласованность нескольких персонажей/объектов, несколько разрешений (360p–1080p), переменную длительность (1–15 секунд) и генерацию аудио.

<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="images" type="object[]" required={true}>
  Список референсных изображений (1–7 изображений)

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

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="type" type="string" required={true}>
      Тип референсного изображения: subject означает генерацию видео с персонажем/объектом с референсного изображения в качестве основного субъекта; background означает генерацию видео с использованием сцены/окружения с референсного изображения в качестве фона

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

    <ParamField body="ref_name" type="string" required={true}>
      Короткое идентификационное имя референсного изображения, используемое для ссылки на него в prompt с помощью синтаксиса @ref\_name; после @ref\_name должен следовать пробел
    </ParamField>

    <ParamField body="image_url" type="string" required={true}>
      URL-адрес референсного изображения
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Текстовое описание сцены; используйте синтаксис @ref\_name для ссылки на загруженные референсные изображения (например, «@hero бежит в @city»). После @ref\_name должен следовать пробел, а имя ссылки должно совпадать с ref\_name в images
</ParamField>

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

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

<ParamField body="resolution" type="string" default="720p">
  Разрешение выходного видео

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

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

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

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

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

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