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

# Veo 3.1 — генерация видео по изображению

<Info>
  API версии Veo 3.1 Preview уже автоматически совместим с этим интерфейсом
</Info>

Используйте модель генерации видео Veo 3.1 для создания высококачественного видеоконтента на основе входного изображения и текстового описания. Этот интерфейс работает асинхронно; для получения итогового результата необходимо выполнить запрос по task\_id.

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

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

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

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

<ParamField body="prompt" type="string" required={true}>
  Текстовая строка, описывающая видео, которое вы хотите сгенерировать.
</ParamField>

<ParamField body="image" type="string" required={false}>
  Входное изображение; поддерживается передача через URL или в формате base64.
</ParamField>

<ParamField body="last_image" type="string" required={false}>
  Конечное изображение, используемое для заполнения последнего кадра видео. Поддерживается передача через URL или в формате base64.
</ParamField>

<ParamField body="reference_images" type="object[]" required={false}>
  Список максимум из трех изображений типа `asset` или максимум одного изображения типа `style`, используемый для описания референсных изображений, которые модель будет использовать при генерации видео.

  <Expandable title="properties">
    <ParamField body="image" type="string" required={false}>
      Референсное изображение; поддерживается передача через URL или в формате base64.
    </ParamField>

    <ParamField body="reference_type" type="string" required={true}>
      Указывает тип предоставленного референсного изображения. Поддерживаются следующие значения:

      * `asset`: референсное изображение предоставляет материалы для генерируемого видео, например сцену, объект или персонажа.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  Задает соотношение сторон генерируемого видео.

  Перечисляемые значения: `16:9`, `9:16`. Значение по умолчанию: `16:9`.
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  Длительность видеофайла, который вы хотите сгенерировать, в секундах.

  Перечисляемые значения: `4`, `6`, `8`; при использовании `reference_images` доступно только значение `8`.

  Значение по умолчанию: `8`.
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  Указывает, нужно ли использовать Gemini для улучшения вашего промпта. Поддерживается только `true`.

  Значение по умолчанию: `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  Указывает, нужно ли генерировать аудио для видео.
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  Текстовая строка, описывающая содержимое, генерацию которого модель должна избегать.
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  Настройка безопасности, управляющая тем, разрешена ли генерация людей или лиц.

  Перечисляемые значения:

  * `allow_adult` (по умолчанию): разрешена генерация только взрослых
  * `dont_allow`: не разрешать наличие людей или лиц на изображении
  * `allow_all`: разрешена генерация людей всех возрастов (проект должен находиться в allowlist)
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  Разрешение генерируемого видео.

  Перечисляемые значения: `720p` (по умолчанию) или `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  Количество образцов видео, которые нужно сгенерировать.

  Диапазон значений: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  Число, используемое для инициализации процесса случайной генерации. Использование одного и того же seed, промпта и других параметров приведет к одинаковому выходному видео, делая процесс генерации детерминированным.

  Диапазон значений: 0-4,294,967,295
</ParamField>

## Параметры ответа

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