Skip to main content
POST
Veo 3.1 — генерация видео по изображению
API версии Veo 3.1 Preview уже автоматически совместим с этим интерфейсом
Используйте модель генерации видео Veo 3.1 для создания высококачественного видеоконтента на основе входного изображения и текстового описания. Этот интерфейс работает асинхронно; для получения итогового результата необходимо выполнить запрос по task_id.

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

string
обязательно
Перечисляемое значение: application/json
string
обязательно
Формат аутентификации Bearer: Bearer {{API 密钥}}.

Тело запроса

string
обязательно
Текстовая строка, описывающая видео, которое вы хотите сгенерировать.
string
Входное изображение; поддерживается передача через URL или в формате base64.
string
Конечное изображение, используемое для заполнения последнего кадра видео. Поддерживается передача через URL или в формате base64.
object[]
Список максимум из трех изображений типа asset или максимум одного изображения типа style, используемый для описания референсных изображений, которые модель будет использовать при генерации видео.
string
Задает соотношение сторон генерируемого видео.Перечисляемые значения: 16:9, 9:16. Значение по умолчанию: 16:9.
integer
Длительность видеофайла, который вы хотите сгенерировать, в секундах.Перечисляемые значения: 4, 6, 8; при использовании reference_images доступно только значение 8.Значение по умолчанию: 8.
boolean
Указывает, нужно ли использовать Gemini для улучшения вашего промпта. Поддерживается только true.Значение по умолчанию: true
boolean
обязательно
Указывает, нужно ли генерировать аудио для видео.
string
Текстовая строка, описывающая содержимое, генерацию которого модель должна избегать.
string
Настройка безопасности, управляющая тем, разрешена ли генерация людей или лиц.Перечисляемые значения:
  • allow_adult (по умолчанию): разрешена генерация только взрослых
  • dont_allow: не разрешать наличие людей или лиц на изображении
  • allow_all: разрешена генерация людей всех возрастов (проект должен находиться в allowlist)
string
Разрешение генерируемого видео.Перечисляемые значения: 720p (по умолчанию) или 1080p
integer
Количество образцов видео, которые нужно сгенерировать.Диапазон значений: 1-4
uint32
Число, используемое для инициализации процесса случайной генерации. Использование одного и того же seed, промпта и других параметров приведет к одинаковому выходному видео, делая процесс генерации детерминированным.Диапазон значений: 0-4,294,967,295

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

string
обязательно
task_id асинхронной задачи. Используйте этот task_id для запроса API получения результата задачи, чтобы получить результат генерации