Создать видео с помощью Veo

Gemini API обеспечивает доступ к Veo 2 , современной модели создания видео Google. Veo предназначен для того, чтобы помочь вам создавать приложения искусственного интеллекта нового поколения, которые преобразуют пользовательские подсказки и изображения в высококачественные видеоматериалы.

Это руководство поможет вам начать работу с Veo с использованием API Gemini.

О Вео

Veo — самая мощная модель Google для создания видео на сегодняшний день. Он создает видеоролики в широком диапазоне кинематографических и визуальных стилей, улавливая нюансы и последовательно отображая сложные детали в разных кадрах.

Чтобы узнать больше и увидеть пример вывода, ознакомьтесь с обзором Google DeepMind Veo .

Технические характеристики

Видео, созданные Veo, помечаются водяными знаками с помощью SynthID , нашего инструмента для нанесения водяных знаков и идентификации контента, созданного искусственным интеллектом, и проходят через фильтры безопасности и процессы проверки запоминания, которые помогают снизить риски конфиденциальности, авторских прав и предвзятости.

Прежде чем начать

Прежде чем вызывать API Gemini, убедитесь, что выбранный вами SDK установлен, а ключ API Gemini настроен и готов к использованию.

Чтобы использовать Veo с SDK Google Gen AI, убедитесь, что у вас установлена ​​одна из следующих версий:

• Python v1.10.0 или новее
• TypeScript и JavaScript версии 0.8.0 или более поздней версии
• Перейти на версию 1.0.0 или новее

Создание видео

В этом разделе представлены примеры кода для создания видео с помощью текстовых подсказок и изображений .

Создать из текста

Вы можете использовать следующий код для создания видео с помощью Veo:

import time
from google import genai
from google.genai import types

client = genai.Client()  # read API key from GOOGLE_API_KEY

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
    config=types.GenerateVideosConfig(
        person_generation="dont_allow",  # "dont_allow" or "allow_adult"
        aspect_ratio="16:9",  # "16:9" or "9:16"
    ),
)

while not operation.done:
    time.sleep(20)
    operation = client.operations.get(operation)

for n, generated_video in enumerate(operation.response.generated_videos):
    client.files.download(file=generated_video.video)
    generated_video.video.save(f"video{n}.mp4")  # save the video

# Use curl to send a POST request to the predictLongRunning endpoint
# The request body includes the prompt for video generation
curl "${BASE_URL}/models/veo-2.0-generate-001:predictLongRunning?key=${GOOGLE_API_KEY}" \
  -H "Content-Type: application/json" \
  -X "POST" \
  -d '{
    "instances": [{
        "prompt": "Panning wide shot of a calico kitten sleeping in the sunshine"
      }
    ],
    "parameters": {
      "aspectRatio": "16:9",
      "personGeneration": "dont_allow",
    }
  }' | tee result.json | jq .name | sed 's/"//g' > op_name

Выполнение этого кода занимает около 2–3 минут, хотя это может занять больше времени, если ресурсы ограничены. После завершения работы вы должны увидеть видео, которое выглядит примерно так:

Если вместо видео вы видите сообщение об ошибке, это означает, что ресурсы ограничены и ваш запрос не может быть выполнен. В этом случае запустите код еще раз.

Сгенерированные видео хранятся на сервере 2 дня, после чего удаляются. Если вы хотите сохранить локальную копию сгенерированного видео, вам необходимо запустить result() и save() в течение двух дней после создания.

Генерировать из изображений

Вы также можете создавать видео, используя изображения. Следующий код генерирует изображение с помощью Imagen, а затем использует сгенерированное изображение в качестве начального кадра для сгенерированного видео.

Сначала сгенерируйте изображение с помощью Imagen :

prompt="Panning wide shot of a calico kitten sleeping in the sunshine",

imagen = client.models.generate_images(
    model="imagen-3.0-generate-002",
    prompt=prompt,
    config=types.GenerateImagesConfig(
      aspect_ratio="16:9",
      number_of_images=1
    )
)

imagen.generated_images[0].image

Затем сгенерируйте видео, используя полученное изображение в качестве первого кадра:

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt=prompt,
    image = imagen.generated_images[0].image,
    config=types.GenerateVideosConfig(
      # person_generation only accepts "dont_allow" for image-to-video
      aspect_ratio="16:9",  # "16:9" or "9:16"
      number_of_videos=2
    ),
)

# Wait for videos to generate
 while not operation.done:
  time.sleep(20)
  operation = client.operations.get(operation)

for n, video in enumerate(operation.response.generated_videos):
    fname = f'with_image_input{n}.mp4'
    print(fname)
    client.files.download(file=video.video)
    video.video.save(fname)

Параметры модели Veo

(Соглашения об именах зависят от языка программирования.)

• prompt : текстовая подсказка для видео. Параметр image , если он присутствует, является необязательным.
• image : изображение, которое будет использоваться в качестве первого кадра видео. Если параметр prompt присутствует, он является необязательным.
• negativePrompt : текстовая строка, описывающая все, что вы хотите запретить модели генерировать.
• aspectRatio : изменяет соотношение сторон создаваемого видео. Поддерживаемые значения: "16:9" и "9:16" . По умолчанию установлено "16:9" .
• personGeneration : разрешить модели создавать видео с людьми. Поддерживаются следующие значения:
  • Генерация текста в видео:
    • "dont_allow" : не разрешать включение людей или лиц.
    • "allow_adult" : создавать видео, в которых участвуют взрослые, но не дети.
  • Генерация изображения в видео:
    • "dont_allow" : значение по умолчанию и единственное значение для создания изображения в видео.
• numberOfVideos : запрошено выходное видео, 1 или 2 .
• durationSeconds : продолжительность каждого выходного видео в секундах, от 5 до 8 .
• enhance_prompt : включить или отключить переписчик подсказок. Включено по умолчанию.

Что стоит попробовать

Чтобы получить максимальную отдачу от Veo, включите в свои подсказки терминологию, специфичную для видео. Veo понимает широкий спектр терминов, связанных с:

• Композиция кадра: укажите кадр и количество объектов в кадре (например, «одиночный снимок», «два кадра», «снимок через плечо»).
• Позиционирование и движение камеры. Управляйте местоположением и движением камеры, используя такие термины, как «уровень глаз», «большой угол», «червячный глаз», «снимок с тележки», «снимок с масштабированием», «панорамный снимок» и «следящий снимок».
• Эффекты фокуса и линзы. Используйте такие термины, как «мелкий фокус», «глубокий фокус», «мягкий фокус», «макрообъектив» и «широкоугольный объектив», чтобы добиться определенных визуальных эффектов.
• Общий стиль и тема: руководите творческим направлением Veo, определяя такие стили, как «научная фантастика», «романтическая комедия», «боевик» или «анимация». Вы также можете описать нужные предметы и фон, например «городской пейзаж», «природа», «транспортные средства» или «животные».

Veo оперативное руководство

В этом разделе руководства Veo содержатся примеры видеороликов, которые вы можете создать с помощью Veo, и показано, как изменять подсказки для получения различных результатов.

Защитные фильтры

Veo применяет фильтры безопасности в Gemini, чтобы гарантировать, что созданные видео и загруженные фотографии не содержат оскорбительного содержания. Подсказки, нарушающие наши условия и правила, блокируются.

Основы написания подсказок

Хорошие подсказки описательны и ясны. Чтобы сгенерированное видео было максимально близко к тому, что вы хотите, начните с определения вашей основной идеи, а затем уточните ее, добавив ключевые слова и модификаторы.

В приглашение должны быть включены следующие элементы:

• Тема : объект, человек, животное или пейзаж, который вы хотите видеть в своем видео.
• Контекст : фон или контекст, в котором находится объект.
• Действие : Что делает субъект (например, идет , бежит или поворачивает голову ).
• Стиль : он может быть общим или очень конкретным. Рассмотрите возможность использования определенных ключевых слов в стиле фильма, например фильма ужасов , фильма нуар , или стилей анимации, например стиля мультфильма .
• Движение камеры : [Необязательно] Что делает камера, например вид сверху , на уровне глаз , снимок сверху или снимок с низкого угла .
• Композиция : [Необязательно] Кадр кадра, например общий план , крупный план или очень крупный план .
• Атмосфера : [Необязательно] Как цвет и свет влияют на сцену, например синие тона , ночные или теплые тона .

Дополнительные советы по написанию подсказок

Следующие советы помогут вам написать подсказки для создания видео:

• Используйте описательный язык : используйте прилагательные и наречия, чтобы нарисовать четкую картину Veo.
• Предоставьте контекст . При необходимости добавьте справочную информацию, которая поможет вашей модели понять, чего вы хотите.
• Ссылайтесь на конкретные художественные стили . Если вы имеете в виду определенную эстетику, ссылайтесь на конкретные художественные стили или художественные направления.
• Используйте инструменты быстрого проектирования . Рассмотрите возможность изучения инструментов или ресурсов быстрого проектирования, которые помогут вам усовершенствовать свои подсказки и достичь оптимальных результатов. Для получения дополнительной информации посетите раздел «Введение в быстрое проектирование» .
• Улучшите детали лица на личных и групповых изображениях . Укажите детали лица в качестве фокуса фотографии, например, используя слово «портрет» в подсказке.

Примеры подсказок и вывода

В этом разделе представлено несколько подсказок, подчеркивающих, как описательные детали могут улучшить результат каждого видео.

сосульки

В этом видеоролике показано, как можно использовать элементы основы написания подсказок в подсказках.

Быстрый	Сгенерированный вывод
Крупным планом (композиция) тающих сосулек (объект) на замерзшей каменной стене (контекст) с холодными синими тонами (атмосфера), увеличенное изображение (движение камеры) с сохранением деталей капель воды крупным планом (действие).

Мужчина по телефону

Эти видеоролики демонстрируют, как вы можете изменить свое приглашение, добавив в него все более конкретные детали, чтобы Veo мог уточнить выходные данные по своему вкусу.

Быстрый	Сгенерированный вывод	Анализ
Камера поворачивается, показывая крупным планом отчаявшегося мужчину в зеленом плаще. Он звонит по вращающемуся настенному телефону с зеленой неоновой лампочкой. Это похоже на сцену из фильма.		Это первое видео, созданное на основе подсказки.
В кинематографическом кадре крупным планом показано, как отчаявшийся мужчина в потертом зеленом плаще набирает номер по дисковому телефону, установленному на шероховатой кирпичной стене, залитой жутким светом зеленой неоновой вывески. Камера приближается, показывая напряжение в его челюсти и отчаяние, отразившееся на его лице, когда он изо всех сил пытается позвонить. Небольшая глубина резкости фокусируется на его нахмуренном лбу и черном дисковом телефоне, размывая фон в море неоновых цветов и нечетких теней, создавая ощущение безотлагательности и изоляции.		Более подробная подсказка приводит к созданию более целенаправленного видео с более богатой средой.
Видео с плавным движением, в котором изображен отчаявшийся мужчина в зеленом плаще, пользующийся старинным дисковым телефоном у стены, залитой жутким зеленым неоновым светом. Камера стартует со среднего расстояния, медленно приближаясь к лицу мужчины, показывая его безумное выражение и пот на лбу, когда он срочно набирает номер телефона. Все внимание сосредоточено на руках мужчины, его пальцы возятся с циферблатом, пока он отчаянно пытается подключиться. Зеленый неоновый свет отбрасывает на стену длинные тени, добавляя напряженности атмосфере. Сцена создана так, чтобы подчеркнуть изоляцию и отчаяние мужчины, подчеркивая резкий контраст между ярким светом неона и мрачной решимостью мужчины.		Добавление большего количества деталей придает объекту реалистичность и создает интенсивную и яркую сцену.

Снежный барс

В этом примере демонстрируется вывод, который Veo может сгенерировать для простого приглашения.

Быстрый	Сгенерированный вывод
Симпатичное существо с мехом, похожим на снежного барса, гуляет по зимнему лесу, 3D-рендеринг в мультяшном стиле.

Бегущий снежный барс

Это приглашение содержит более подробную информацию и демонстрирует сгенерированный результат, который может быть ближе к тому, что вы хотите в своем видео.

Быстрый

Сгенерированный вывод

Создайте короткую 3D-анимационную сцену в веселом мультяшном стиле. Милое существо с мехом, похожим на снежного барса, большими выразительными глазами и дружелюбным округлым телом радостно скачет по причудливому зимнему лесу. В сцене должны быть округлые, покрытые снегом деревья, нежно падающие снежинки и теплый солнечный свет, проникающий сквозь ветви. Подпрыгивающие движения существа и широкая улыбка должны передавать чистый восторг. Стремитесь к оптимистичному, душевному тону с яркими веселыми цветами и игривой анимацией.

Примеры написания элементов

Эти примеры показывают, как уточнить подсказки по каждому базовому элементу.

Предмет

В этом примере показано, как указать описание темы.

Описание предмета	Быстрый	Сгенерированный вывод
Описание может включать предмет или несколько предметов и действий. Здесь наша тема — «белый бетонный жилой дом».	Архитектурная визуализация белого бетонного жилого дома с плавными органическими формами, плавно сочетающимися с пышной зеленью и футуристическими элементами.

Контекст

В этом примере показано, как указать контекст.

Контекст	Быстрый	Сгенерированный вывод
Фон или контекст, в котором будет помещен предмет, очень важен. Попробуйте разместить объект съемки на разных фонах, например, на оживленной улице или в открытом космосе.	Спутник, плывущий в космическом пространстве, на фоне Луны и звезд.

Действие

В этом примере показано, как указать действие.

Действие	Быстрый	Сгенерированный вывод
Что делает субъект: ходит, бежит или поворачивает голову.	Общий план женщины, идущей по пляжу, выглядящей довольной и расслабленной и смотрящей на горизонт на закате.

Стиль

В этом примере показано, как указать стиль.

Стиль	Быстрый	Сгенерированный вывод
Вы можете добавить ключевые слова, чтобы улучшить качество генерации и приблизить ее к предполагаемому стилю, например малая глубина резкости, кадр из фильма, минималистичный, сюрреалистический, винтажный, футуристический или двойная экспозиция.	Стиль фильма-нуар, мужчина и женщина идут по улице, тайна, кинематографичность, черно-белое.

Движение камеры

В этом примере показано, как указать движение камеры.

Движение камеры	Быстрый	Сгенерированный вывод
Варианты движения камеры включают съемку POV, вид с воздуха, вид слежения за дроном или съемку слежения.	Кадр от лица старинной машины, едущей под дождем, Канада ночью, кинематографический вид.

Состав

В этом примере показано, как указать композицию.

Состав	Быстрый	Сгенерированный вывод
Как построен кадр (широкий план, крупный план, низкий ракурс).	Чрезвычайно крупный план глаза с отражением города.
	Создайте широкоформатное видео серфера, идущего по пляжу с доской для серфинга, красивого заката, кинематографического качества.

атмосфера

В этом примере показано, как указать атмосферу.

атмосфера	Быстрый	Сгенерированный вывод
Цветовые палитры играют жизненно важную роль в фотографии, влияя на настроение и передавая желаемые эмоции. Попробуйте такие вещи, как «приглушенные оранжевые теплые тона», «естественный свет», «восход солнца» или «закат». Например, теплая золотая палитра может придать фотографии романтическую и атмосферную атмосферу.	Крупный план девушки, держащей очаровательного щенка золотистого ретривера в парке при солнечном свете.
	Кинематографический снимок грустной женщины, едущей в автобусе под дождем, крупным планом, прохладные голубые тона, грустное настроение.

Используйте эталонные изображения для создания видео

Вы можете оживить изображения, используя функцию преобразования изображения в видео Veo. Вы можете использовать существующие ресурсы или попробовать Imagen создать что-то новое.

Быстрый	Сгенерированный вывод
Зайчик с шоколадной конфеткой.
Зайка убегает.

Негативные подсказки

Отрицательные подсказки могут стать мощным инструментом, помогающим указать элементы, которые вам не нужны в видео. Опишите, что вы хотите запретить модели генерировать после фразы «Отрицательный запрос». Следуйте этим советам:

• ❌ Не используйте поучительные выражения или такие слова, как «нет» или «нет» . Например, «Нет стен» или «Не показывать стены».

• ✅ Опишите то, что вы не хотите видеть. Например, «стена, рамка», что означает, что вам не нужна стена или рамка в видео.

Быстрый	Сгенерированный вывод
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра.
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра. При негативной подсказке – городской фон, рукотворные сооружения, мрачная, грозовая или угрожающая атмосфера.

Соотношения сторон

Генерация видео Gemini Veo поддерживает следующие два соотношения сторон:

Широкоэкранный

Эта подсказка является примером широкоэкранного соотношения сторон 16:9.

Быстрый	Сгенерированный вывод
Создайте видео с изображением человека, управляющего красным кабриолетом в Палм-Спрингс, 1970-е годы, теплый солнечный свет, длинные тени, с помощью дрона слежения.

Портрет

Эта подсказка является примером портретного соотношения сторон 9:16.

Быстрый

Сгенерированный вывод

Создайте видео, демонстрирующее плавное движение величественного гавайского водопада среди пышного тропического леса. Сосредоточьтесь на реалистичном потоке воды, детализированной листве и естественном освещении, чтобы передать спокойствие. Запечатлейте стремительную воду, туманную атмосферу и пятнистый солнечный свет, проникающий сквозь плотный полог. Используйте плавные кинематографические движения камеры, чтобы продемонстрировать водопад и его окрестности. Стремитесь к мирному, реалистичному тону, переносящему зрителя в безмятежную красоту тропического леса Гавайев.

Что дальше

• Получите больше опыта в создании видеороликов с использованием искусственного интеллекта с помощью Veo Colab .

Gemini API обеспечивает доступ к Veo 2 , современной модели создания видео Google. Veo предназначен для того, чтобы помочь вам создавать приложения искусственного интеллекта нового поколения, которые преобразуют пользовательские подсказки и изображения в высококачественные видеоматериалы.

Это руководство поможет вам начать работу с Veo с использованием API Gemini.

О Вео

Veo — самая мощная модель Google для создания видео на сегодняшний день. Он создает видеоролики в широком диапазоне кинематографических и визуальных стилей, улавливая нюансы и последовательно отображая сложные детали в разных кадрах.

Чтобы узнать больше и увидеть пример вывода, ознакомьтесь с обзором Google DeepMind Veo .

Технические характеристики

Видео, созданные Veo, помечаются водяными знаками с помощью SynthID , нашего инструмента для нанесения водяных знаков и идентификации контента, созданного искусственным интеллектом, и проходят через фильтры безопасности и процессы проверки запоминания, которые помогают снизить риски конфиденциальности, авторских прав и предвзятости.

Прежде чем начать

Прежде чем вызывать API Gemini, убедитесь, что выбранный вами SDK установлен, а ключ API Gemini настроен и готов к использованию.

Чтобы использовать Veo с SDK Google Gen AI, убедитесь, что у вас установлена ​​одна из следующих версий:

• Python v1.10.0 или новее
• TypeScript и JavaScript версии 0.8.0 или более поздней версии
• Перейти на версию 1.0.0 или новее

Создание видео

В этом разделе представлены примеры кода для создания видео с помощью текстовых подсказок и изображений .

Создать из текста

Вы можете использовать следующий код для создания видео с помощью Veo:

import time
from google import genai
from google.genai import types

client = genai.Client()  # read API key from GOOGLE_API_KEY

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
    config=types.GenerateVideosConfig(
        person_generation="dont_allow",  # "dont_allow" or "allow_adult"
        aspect_ratio="16:9",  # "16:9" or "9:16"
    ),
)

while not operation.done:
    time.sleep(20)
    operation = client.operations.get(operation)

for n, generated_video in enumerate(operation.response.generated_videos):
    client.files.download(file=generated_video.video)
    generated_video.video.save(f"video{n}.mp4")  # save the video

# Use curl to send a POST request to the predictLongRunning endpoint
# The request body includes the prompt for video generation
curl "${BASE_URL}/models/veo-2.0-generate-001:predictLongRunning?key=${GOOGLE_API_KEY}" \
  -H "Content-Type: application/json" \
  -X "POST" \
  -d '{
    "instances": [{
        "prompt": "Panning wide shot of a calico kitten sleeping in the sunshine"
      }
    ],
    "parameters": {
      "aspectRatio": "16:9",
      "personGeneration": "dont_allow",
    }
  }' | tee result.json | jq .name | sed 's/"//g' > op_name

Выполнение этого кода занимает около 2–3 минут, хотя это может занять больше времени, если ресурсы ограничены. После завершения работы вы должны увидеть видео, которое выглядит примерно так:

Если вместо видео вы видите сообщение об ошибке, это означает, что ресурсы ограничены и ваш запрос не может быть выполнен. В этом случае запустите код еще раз.

Сгенерированные видео хранятся на сервере 2 дня, после чего удаляются. Если вы хотите сохранить локальную копию сгенерированного видео, вам необходимо запустить result() и save() в течение двух дней после создания.

Генерировать из изображений

Вы также можете создавать видео, используя изображения. Следующий код генерирует изображение с помощью Imagen, а затем использует сгенерированное изображение в качестве начального кадра для сгенерированного видео.

Сначала сгенерируйте изображение с помощью Imagen :

prompt="Panning wide shot of a calico kitten sleeping in the sunshine",

imagen = client.models.generate_images(
    model="imagen-3.0-generate-002",
    prompt=prompt,
    config=types.GenerateImagesConfig(
      aspect_ratio="16:9",
      number_of_images=1
    )
)

imagen.generated_images[0].image

Затем сгенерируйте видео, используя полученное изображение в качестве первого кадра:

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt=prompt,
    image = imagen.generated_images[0].image,
    config=types.GenerateVideosConfig(
      # person_generation only accepts "dont_allow" for image-to-video
      aspect_ratio="16:9",  # "16:9" or "9:16"
      number_of_videos=2
    ),
)

# Wait for videos to generate
 while not operation.done:
  time.sleep(20)
  operation = client.operations.get(operation)

for n, video in enumerate(operation.response.generated_videos):
    fname = f'with_image_input{n}.mp4'
    print(fname)
    client.files.download(file=video.video)
    video.video.save(fname)

Параметры модели Veo

(Соглашения об именах зависят от языка программирования.)

• prompt : текстовая подсказка для видео. Параметр image , если он присутствует, является необязательным.
• image : изображение, которое будет использоваться в качестве первого кадра видео. Если параметр prompt присутствует, он является необязательным.
• negativePrompt : текстовая строка, описывающая все, что вы хотите запретить модели генерировать.
• aspectRatio : изменяет соотношение сторон создаваемого видео. Поддерживаемые значения: "16:9" и "9:16" . По умолчанию установлено "16:9" .
• personGeneration : разрешить модели создавать видео с людьми. Поддерживаются следующие значения:
  • Генерация текста в видео:
    • "dont_allow" : не разрешать включение людей или лиц.
    • "allow_adult" : создавать видео, в которых участвуют взрослые, но не дети.
  • Генерация изображения в видео:
    • "dont_allow" : значение по умолчанию и единственное значение для создания изображения в видео.
• numberOfVideos : запрошено выходное видео, 1 или 2 .
• durationSeconds : продолжительность каждого выходного видео в секундах, от 5 до 8 .
• enhance_prompt : включить или отключить переписчик подсказок. Включено по умолчанию.

Что стоит попробовать

Чтобы получить максимальную отдачу от Veo, включите в свои подсказки терминологию, специфичную для видео. Veo понимает широкий спектр терминов, связанных с:

• Композиция кадра: укажите кадр и количество объектов в кадре (например, «одиночный снимок», «два кадра», «снимок через плечо»).
• Позиционирование и движение камеры. Управляйте местоположением и движением камеры, используя такие термины, как «уровень глаз», «большой угол», «червячный глаз», «снимок с тележки», «снимок с масштабированием», «панорамный снимок» и «следящий снимок».
• Эффекты фокуса и линзы. Используйте такие термины, как «мелкий фокус», «глубокий фокус», «мягкий фокус», «макрообъектив» и «широкоугольный объектив», чтобы добиться определенных визуальных эффектов.
• Общий стиль и тема: руководите творческим направлением Veo, определяя такие стили, как «научная фантастика», «романтическая комедия», «боевик» или «анимация». Вы также можете описать нужные предметы и фон, например «городской пейзаж», «природа», «транспортные средства» или «животные».

Veo оперативное руководство

В этом разделе руководства Veo содержатся примеры видеороликов, которые вы можете создать с помощью Veo, и показано, как изменять подсказки для получения различных результатов.

Защитные фильтры

Veo применяет фильтры безопасности в Gemini, чтобы гарантировать, что созданные видео и загруженные фотографии не содержат оскорбительного содержания. Подсказки, нарушающие наши условия и правила, блокируются.

Основы написания подсказок

Хорошие подсказки описательны и ясны. Чтобы сгенерированное видео было максимально близко к тому, что вы хотите, начните с определения вашей основной идеи, а затем уточните ее, добавив ключевые слова и модификаторы.

В приглашение должны быть включены следующие элементы:

• Тема : объект, человек, животное или пейзаж, который вы хотите видеть в своем видео.
• Контекст : фон или контекст, в котором находится объект.
• Действие : Что делает субъект (например, идет , бежит или поворачивает голову ).
• Стиль : он может быть общим или очень конкретным. Рассмотрите возможность использования определенных ключевых слов в стиле фильма, например фильма ужасов , фильма нуар , или стилей анимации, например стиля мультфильма .
• Движение камеры : [Необязательно] Что делает камера, например вид сверху , на уровне глаз , снимок сверху или снимок с низкого угла .
• Композиция : [Необязательно] Кадр кадра, например общий план , крупный план или очень крупный план .
• Атмосфера : [Необязательно] Как цвет и свет влияют на сцену, например синие тона , ночные или теплые тона .

Дополнительные советы по написанию подсказок

Следующие советы помогут вам написать подсказки для создания видео:

• Используйте описательный язык : используйте прилагательные и наречия, чтобы нарисовать четкую картину Veo.
• Предоставьте контекст . При необходимости добавьте справочную информацию, которая поможет вашей модели понять, чего вы хотите.
• Ссылайтесь на конкретные художественные стили . Если вы имеете в виду определенную эстетику, ссылайтесь на конкретные художественные стили или художественные направления.
• Используйте инструменты быстрого проектирования . Рассмотрите возможность изучения инструментов или ресурсов быстрого проектирования, которые помогут вам усовершенствовать свои подсказки и достичь оптимальных результатов. Для получения дополнительной информации посетите раздел «Введение в быстрое проектирование» .
• Улучшите детали лица на личных и групповых изображениях . Укажите детали лица в качестве фокуса фотографии, например, используя слово «портрет» в подсказке.

Примеры подсказок и вывода

В этом разделе представлено несколько подсказок, подчеркивающих, как описательные детали могут улучшить результат каждого видео.

сосульки

В этом видеоролике показано, как можно использовать элементы основы написания подсказок в подсказках.

Быстрый	Сгенерированный вывод
Крупным планом (композиция) тающих сосулек (объект) на замерзшей каменной стене (контекст) с холодными синими тонами (атмосфера), увеличенное изображение (движение камеры) с сохранением деталей капель воды крупным планом (действие).

Мужчина по телефону

Эти видеоролики демонстрируют, как вы можете изменить свое приглашение, добавив в него все более конкретные детали, чтобы Veo мог уточнить выходные данные по своему вкусу.

Быстрый	Сгенерированный вывод	Анализ
Камера поворачивается, показывая крупным планом отчаявшегося мужчину в зеленом плаще. Он звонит по вращающемуся настенному телефону с зеленой неоновой лампочкой. Это похоже на сцену из фильма.		Это первое видео, созданное на основе подсказки.
В кинематографическом кадре крупным планом показано, как отчаявшийся мужчина в потертом зеленом плаще набирает номер по дисковому телефону, установленному на шероховатой кирпичной стене, залитой жутким светом зеленой неоновой вывески. Камера приближается, показывая напряжение в его челюсти и отчаяние, отразившееся на его лице, когда он изо всех сил пытается позвонить. Небольшая глубина резкости фокусируется на его нахмуренном лбу и черном дисковом телефоне, размывая фон в море неоновых цветов и нечетких теней, создавая ощущение безотлагательности и изоляции.		Более подробная подсказка приводит к созданию более целенаправленного видео с более богатой средой.
Видео с плавным движением, в котором изображен отчаявшийся мужчина в зеленом плаще, пользующийся старинным дисковым телефоном у стены, залитой жутким зеленым неоновым светом. Камера стартует со среднего расстояния, медленно приближаясь к лицу мужчины, показывая его безумное выражение и пот на лбу, когда он срочно набирает номер телефона. Все внимание сосредоточено на руках мужчины, его пальцы возятся с циферблатом, пока он отчаянно пытается подключиться. Зеленый неоновый свет отбрасывает на стену длинные тени, добавляя напряженности атмосфере. Сцена создана так, чтобы подчеркнуть изоляцию и отчаяние мужчины, подчеркивая резкий контраст между ярким светом неона и мрачной решимостью мужчины.		Добавление большего количества деталей придает объекту реалистичность и создает интенсивную и яркую сцену.

Снежный барс

В этом примере демонстрируется вывод, который Veo может сгенерировать для простого приглашения.

Быстрый	Сгенерированный вывод
Симпатичное существо с мехом, похожим на снежного барса, гуляет по зимнему лесу, 3D-рендеринг в мультяшном стиле.

Бегущий снежный барс

Это приглашение содержит более подробную информацию и демонстрирует сгенерированный результат, который может быть ближе к тому, что вы хотите в своем видео.

Быстрый

Сгенерированный вывод

Создайте короткую 3D-анимационную сцену в веселом мультяшном стиле. Милое существо с мехом, похожим на снежного барса, большими выразительными глазами и дружелюбным округлым телом радостно скачет по причудливому зимнему лесу. В сцене должны быть округлые, покрытые снегом деревья, нежно падающие снежинки и теплый солнечный свет, проникающий сквозь ветви. Подпрыгивающие движения существа и широкая улыбка должны передавать чистый восторг. Стремитесь к оптимистичному, душевному тону с яркими веселыми цветами и игривой анимацией.

Примеры написания элементов

Эти примеры показывают, как уточнить подсказки по каждому базовому элементу.

Предмет

В этом примере показано, как указать описание темы.

Описание предмета	Быстрый	Сгенерированный вывод
Описание может включать предмет или несколько предметов и действий. Здесь наша тема — «белый бетонный жилой дом».	Архитектурная визуализация белого бетонного жилого дома с плавными органическими формами, плавно сочетающимися с пышной зеленью и футуристическими элементами.

Контекст

В этом примере показано, как указать контекст.

Контекст	Быстрый	Сгенерированный вывод
Фон или контекст, в котором будет помещен предмет, очень важен. Попробуйте разместить объект съемки на разных фонах, например, на оживленной улице или в открытом космосе.	Спутник, плывущий в космическом пространстве, на фоне Луны и звезд.

Действие

В этом примере показано, как указать действие.

Действие	Быстрый	Сгенерированный вывод
Что делает субъект: ходит, бежит или поворачивает голову.	Общий план женщины, идущей по пляжу, выглядящей довольной и расслабленной и смотрящей на горизонт на закате.

Стиль

В этом примере показано, как указать стиль.

Стиль	Быстрый	Сгенерированный вывод
Вы можете добавить ключевые слова, чтобы улучшить качество генерации и приблизить ее к предполагаемому стилю, например малая глубина резкости, кадр из фильма, минималистичный, сюрреалистический, винтажный, футуристический или двойная экспозиция.	Стиль фильма-нуар, мужчина и женщина идут по улице, тайна, кинематографичность, черно-белое.

Движение камеры

В этом примере показано, как указать движение камеры.

Движение камеры	Быстрый	Сгенерированный вывод
Варианты движения камеры включают съемку POV, вид с воздуха, вид слежения за дроном или съемку слежения.	Кадр от лица старинной машины, едущей под дождем, Канада ночью, кинематографический вид.

Состав

В этом примере показано, как указать композицию.

Состав	Быстрый	Сгенерированный вывод
Как построен кадр (широкий план, крупный план, низкий ракурс).	Чрезвычайно крупный план глаза с отражением города.
	Создайте широкоформатное видео серфера, идущего по пляжу с доской для серфинга, красивого заката, кинематографического качества.

атмосфера

В этом примере показано, как указать атмосферу.

атмосфера	Быстрый	Сгенерированный вывод
Цветовые палитры играют жизненно важную роль в фотографии, влияя на настроение и передавая желаемые эмоции. Попробуйте такие вещи, как «приглушенные оранжевые теплые тона», «естественный свет», «восход солнца» или «закат». Например, теплая золотая палитра может придать фотографии романтическую и атмосферную атмосферу.	Крупный план девушки, держащей очаровательного щенка золотистого ретривера в парке при солнечном свете.
	Кинематографический снимок грустной женщины, едущей в автобусе под дождем, крупным планом, прохладные голубые тона, грустное настроение.

Используйте эталонные изображения для создания видео

Вы можете оживить изображения, используя функцию преобразования изображения в видео Veo. Вы можете использовать существующие ресурсы или попробовать Imagen создать что-то новое.

Быстрый	Сгенерированный вывод
Зайчик с шоколадной конфеткой.
Зайка убегает.

Негативные подсказки

Отрицательные подсказки могут стать мощным инструментом, помогающим указать элементы, которые вам не нужны в видео. Опишите, что вы хотите запретить модели генерировать после фразы «Отрицательный запрос». Следуйте этим советам:

• ❌ Не используйте поучительные выражения или такие слова, как «нет» или «нет» . Например, «Нет стен» или «Не показывать стены».

• ✅ Опишите то, что вы не хотите видеть. Например, «стена, рамка», что означает, что вам не нужна стена или рамка в видео.

Быстрый	Сгенерированный вывод
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра.
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра. При негативной подсказке – городской фон, рукотворные сооружения, мрачная, грозовая или угрожающая атмосфера.

Соотношения сторон

Генерация видео Gemini Veo поддерживает следующие два соотношения сторон:

Широкоэкранный

Эта подсказка является примером широкоэкранного соотношения сторон 16:9.

Быстрый	Сгенерированный вывод
Создайте видео с изображением человека, управляющего красным кабриолетом в Палм-Спрингс, 1970-е годы, теплый солнечный свет, длинные тени, с помощью дрона слежения.

Портрет

Эта подсказка является примером портретного соотношения сторон 9:16.

Быстрый

Сгенерированный вывод

Создайте видео, демонстрирующее плавное движение величественного гавайского водопада среди пышного тропического леса. Сосредоточьтесь на реалистичном потоке воды, детализированной листве и естественном освещении, чтобы передать спокойствие. Запечатлейте стремительную воду, туманную атмосферу и пятнистый солнечный свет, проникающий сквозь плотный полог. Используйте плавные кинематографические движения камеры, чтобы продемонстрировать водопад и его окрестности. Стремитесь к мирному, реалистичному тону, переносящему зрителя в безмятежную красоту тропического леса Гавайев.

Что дальше

• Получите больше опыта в создании видеороликов с использованием искусственного интеллекта с помощью Veo Colab .

Gemini API обеспечивает доступ к Veo 2 , современной модели создания видео Google. Veo предназначен для того, чтобы помочь вам создавать приложения искусственного интеллекта нового поколения, которые преобразуют пользовательские подсказки и изображения в высококачественные видеоматериалы.

Это руководство поможет вам начать работу с Veo с использованием API Gemini.

О Вео

Veo — самая мощная модель Google для создания видео на сегодняшний день. Он создает видеоролики в широком диапазоне кинематографических и визуальных стилей, улавливая нюансы и последовательно отображая сложные детали в разных кадрах.

Чтобы узнать больше и увидеть пример вывода, ознакомьтесь с обзором Google DeepMind Veo .

Технические характеристики

Видео, созданные Veo, помечаются водяными знаками с помощью SynthID , нашего инструмента для нанесения водяных знаков и идентификации контента, созданного искусственным интеллектом, и проходят через фильтры безопасности и процессы проверки запоминания, которые помогают снизить риски конфиденциальности, авторских прав и предвзятости.

Прежде чем начать

Прежде чем вызывать API Gemini, убедитесь, что выбранный вами SDK установлен, а ключ API Gemini настроен и готов к использованию.

Чтобы использовать Veo с SDK Google Gen AI, убедитесь, что у вас установлена ​​одна из следующих версий:

• Python v1.10.0 или новее
• TypeScript и JavaScript версии 0.8.0 или более поздней версии
• Перейти на версию 1.0.0 или новее

Создание видео

В этом разделе представлены примеры кода для создания видео с помощью текстовых подсказок и изображений .

Создать из текста

Вы можете использовать следующий код для создания видео с помощью Veo:

import time
from google import genai
from google.genai import types

client = genai.Client()  # read API key from GOOGLE_API_KEY

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
    config=types.GenerateVideosConfig(
        person_generation="dont_allow",  # "dont_allow" or "allow_adult"
        aspect_ratio="16:9",  # "16:9" or "9:16"
    ),
)

while not operation.done:
    time.sleep(20)
    operation = client.operations.get(operation)

for n, generated_video in enumerate(operation.response.generated_videos):
    client.files.download(file=generated_video.video)
    generated_video.video.save(f"video{n}.mp4")  # save the video

# Use curl to send a POST request to the predictLongRunning endpoint
# The request body includes the prompt for video generation
curl "${BASE_URL}/models/veo-2.0-generate-001:predictLongRunning?key=${GOOGLE_API_KEY}" \
  -H "Content-Type: application/json" \
  -X "POST" \
  -d '{
    "instances": [{
        "prompt": "Panning wide shot of a calico kitten sleeping in the sunshine"
      }
    ],
    "parameters": {
      "aspectRatio": "16:9",
      "personGeneration": "dont_allow",
    }
  }' | tee result.json | jq .name | sed 's/"//g' > op_name

Выполнение этого кода занимает около 2–3 минут, хотя это может занять больше времени, если ресурсы ограничены. После завершения работы вы должны увидеть видео, которое выглядит примерно так:

Если вместо видео вы видите сообщение об ошибке, это означает, что ресурсы ограничены и ваш запрос не может быть выполнен. В этом случае запустите код еще раз.

Сгенерированные видео хранятся на сервере 2 дня, после чего удаляются. Если вы хотите сохранить локальную копию сгенерированного видео, вам необходимо запустить result() и save() в течение двух дней после создания.

Генерировать из изображений

Вы также можете создавать видео, используя изображения. Следующий код генерирует изображение с помощью Imagen, а затем использует сгенерированное изображение в качестве начального кадра для сгенерированного видео.

Сначала сгенерируйте изображение с помощью Imagen :

prompt="Panning wide shot of a calico kitten sleeping in the sunshine",

imagen = client.models.generate_images(
    model="imagen-3.0-generate-002",
    prompt=prompt,
    config=types.GenerateImagesConfig(
      aspect_ratio="16:9",
      number_of_images=1
    )
)

imagen.generated_images[0].image

Затем сгенерируйте видео, используя полученное изображение в качестве первого кадра:

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt=prompt,
    image = imagen.generated_images[0].image,
    config=types.GenerateVideosConfig(
      # person_generation only accepts "dont_allow" for image-to-video
      aspect_ratio="16:9",  # "16:9" or "9:16"
      number_of_videos=2
    ),
)

# Wait for videos to generate
 while not operation.done:
  time.sleep(20)
  operation = client.operations.get(operation)

for n, video in enumerate(operation.response.generated_videos):
    fname = f'with_image_input{n}.mp4'
    print(fname)
    client.files.download(file=video.video)
    video.video.save(fname)

Параметры модели Veo

(Соглашения об именах зависят от языка программирования.)

• prompt : текстовая подсказка для видео. Параметр image , если он присутствует, является необязательным.
• image : изображение, которое будет использоваться в качестве первого кадра видео. Если параметр prompt присутствует, он является необязательным.
• negativePrompt : текстовая строка, описывающая все, что вы хотите запретить модели генерировать.
• aspectRatio : изменяет соотношение сторон создаваемого видео. Поддерживаемые значения: "16:9" и "9:16" . По умолчанию установлено "16:9" .
• personGeneration : разрешить модели создавать видео с людьми. Поддерживаются следующие значения:
  • Генерация текста в видео:
    • "dont_allow" : не разрешать включение людей или лиц.
    • "allow_adult" : создавать видео, в которых участвуют взрослые, но не дети.
  • Генерация изображения в видео:
    • "dont_allow" : значение по умолчанию и единственное значение для создания изображения в видео.
• numberOfVideos : запрошено выходное видео, 1 или 2 .
• durationSeconds : продолжительность каждого выходного видео в секундах, от 5 до 8 .
• enhance_prompt : включить или отключить переписчик подсказок. Включено по умолчанию.

Что стоит попробовать

Чтобы получить максимальную отдачу от Veo, включите в свои подсказки терминологию, специфичную для видео. Veo понимает широкий спектр терминов, связанных с:

• Композиция кадра: укажите кадр и количество объектов в кадре (например, «одиночный снимок», «два кадра», «снимок через плечо»).
• Позиционирование и движение камеры. Управляйте местоположением и движением камеры, используя такие термины, как «уровень глаз», «большой угол», «червячный глаз», «снимок с тележки», «снимок с масштабированием», «панорамный снимок» и «следящий снимок».
• Эффекты фокуса и линзы. Используйте такие термины, как «мелкий фокус», «глубокий фокус», «мягкий фокус», «макрообъектив» и «широкоугольный объектив», чтобы добиться определенных визуальных эффектов.
• Общий стиль и тема: руководите творческим направлением Veo, определяя такие стили, как «научная фантастика», «романтическая комедия», «боевик» или «анимация». Вы также можете описать нужные предметы и фон, например «городской пейзаж», «природа», «транспортные средства» или «животные».

Veo оперативное руководство

В этом разделе руководства Veo содержатся примеры видеороликов, которые вы можете создать с помощью Veo, и показано, как изменять подсказки для получения различных результатов.

Защитные фильтры

Veo применяет фильтры безопасности в Gemini, чтобы гарантировать, что созданные видео и загруженные фотографии не содержат оскорбительного содержания. Подсказки, нарушающие наши условия и правила, блокируются.

Основы написания подсказок

Хорошие подсказки описательны и ясны. Чтобы сгенерированное видео было максимально близко к тому, что вы хотите, начните с определения вашей основной идеи, а затем уточните ее, добавив ключевые слова и модификаторы.

В приглашение должны быть включены следующие элементы:

• Тема : объект, человек, животное или пейзаж, который вы хотите видеть в своем видео.
• Контекст : фон или контекст, в котором находится объект.
• Действие : Что делает субъект (например, идет , бежит или поворачивает голову ).
• Стиль : он может быть общим или очень конкретным. Рассмотрите возможность использования определенных ключевых слов в стиле фильма, например фильма ужасов , фильма нуар , или стилей анимации, например стиля мультфильма .
• Движение камеры : [Необязательно] Что делает камера, например вид сверху , на уровне глаз , снимок сверху или снимок с низкого угла .
• Композиция : [Необязательно] Кадр кадра, например общий план , крупный план или очень крупный план .
• Атмосфера : [Необязательно] Как цвет и свет влияют на сцену, например синие тона , ночные или теплые тона .

Дополнительные советы по написанию подсказок

Следующие советы помогут вам написать подсказки для создания видео:

• Используйте описательный язык : используйте прилагательные и наречия, чтобы нарисовать четкую картину Veo.
• Предоставьте контекст . При необходимости добавьте справочную информацию, которая поможет вашей модели понять, чего вы хотите.
• Ссылайтесь на конкретные художественные стили . Если вы имеете в виду определенную эстетику, ссылайтесь на конкретные художественные стили или художественные направления.
• Используйте инструменты быстрого проектирования . Рассмотрите возможность изучения инструментов или ресурсов быстрого проектирования, которые помогут вам усовершенствовать свои подсказки и достичь оптимальных результатов. Для получения дополнительной информации посетите раздел «Введение в быстрое проектирование» .
• Улучшите детали лица на личных и групповых изображениях . Укажите детали лица в качестве фокуса фотографии, например, используя слово «портрет» в подсказке.

Примеры подсказок и вывода

В этом разделе представлено несколько подсказок, подчеркивающих, как описательные детали могут улучшить результат каждого видео.

сосульки

В этом видеоролике показано, как можно использовать элементы основы написания подсказок в подсказках.

Быстрый	Сгенерированный вывод
Крупным планом (композиция) тающих сосулек (объект) на замерзшей каменной стене (контекст) с холодными синими тонами (атмосфера), увеличенное изображение (движение камеры) с сохранением деталей капель воды крупным планом (действие).

Мужчина по телефону

Эти видеоролики демонстрируют, как вы можете изменить свое приглашение, добавив в него все более конкретные детали, чтобы Veo мог уточнить выходные данные по своему вкусу.

Быстрый	Сгенерированный вывод	Анализ
Камера поворачивается, показывая крупным планом отчаявшегося мужчину в зеленом плаще. Он звонит по вращающемуся настенному телефону с зеленой неоновой лампочкой. Это похоже на сцену из фильма.		Это первое видео, созданное на основе подсказки.
В кинематографическом кадре крупным планом показано, как отчаявшийся мужчина в потертом зеленом плаще набирает номер по дисковому телефону, установленному на шероховатой кирпичной стене, залитой жутким светом зеленой неоновой вывески. Камера приближается, показывая напряжение в его челюсти и отчаяние, отразившееся на его лице, когда он изо всех сил пытается позвонить. Небольшая глубина резкости фокусируется на его нахмуренном лбу и черном дисковом телефоне, размывая фон в море неоновых цветов и нечетких теней, создавая ощущение безотлагательности и изоляции.		Более подробная подсказка приводит к созданию более целенаправленного видео с более богатой средой.
Видео с плавным движением, в котором изображен отчаявшийся мужчина в зеленом плаще, пользующийся старинным дисковым телефоном у стены, залитой жутким зеленым неоновым светом. Камера стартует со среднего расстояния, медленно приближаясь к лицу мужчины, показывая его безумное выражение и пот на лбу, когда он срочно набирает номер телефона. Все внимание сосредоточено на руках мужчины, его пальцы возятся с циферблатом, пока он отчаянно пытается подключиться. Зеленый неоновый свет отбрасывает на стену длинные тени, добавляя напряженности атмосфере. Сцена создана так, чтобы подчеркнуть изоляцию и отчаяние мужчины, подчеркивая резкий контраст между ярким светом неона и мрачной решимостью мужчины.		Добавление большего количества деталей придает объекту реалистичность и создает интенсивную и яркую сцену.

Снежный барс

В этом примере демонстрируется вывод, который Veo может сгенерировать для простого приглашения.

Быстрый	Сгенерированный вывод
Симпатичное существо с мехом, похожим на снежного барса, гуляет по зимнему лесу, 3D-рендеринг в мультяшном стиле.

Бегущий снежный барс

Это приглашение содержит более подробную информацию и демонстрирует сгенерированный результат, который может быть ближе к тому, что вы хотите в своем видео.

Быстрый

Сгенерированный вывод

Создайте короткую 3D-анимационную сцену в веселом мультяшном стиле. Милое существо с мехом, похожим на снежного барса, большими выразительными глазами и дружелюбным округлым телом радостно скачет по причудливому зимнему лесу. В сцене должны быть округлые, покрытые снегом деревья, нежно падающие снежинки и теплый солнечный свет, проникающий сквозь ветви. Подпрыгивающие движения существа и широкая улыбка должны передавать чистый восторг. Стремитесь к оптимистичному, душевному тону с яркими веселыми цветами и игривой анимацией.

Примеры написания элементов

Эти примеры показывают, как уточнить подсказки по каждому базовому элементу.

Предмет

В этом примере показано, как указать описание темы.

Описание предмета	Быстрый	Сгенерированный вывод
Описание может включать предмет или несколько предметов и действий. Здесь наша тема — «белый бетонный жилой дом».	Архитектурная визуализация белого бетонного жилого дома с плавными органическими формами, плавно сочетающимися с пышной зеленью и футуристическими элементами.

Контекст

В этом примере показано, как указать контекст.

Контекст	Быстрый	Сгенерированный вывод
Фон или контекст, в котором будет помещен предмет, очень важен. Попробуйте разместить объект съемки на разных фонах, например, на оживленной улице или в открытом космосе.	Спутник, плывущий в космическом пространстве, на фоне Луны и звезд.

Действие

В этом примере показано, как указать действие.

Действие	Быстрый	Сгенерированный вывод
Что делает субъект: ходит, бежит или поворачивает голову.	Общий план женщины, идущей по пляжу, выглядящей довольной и расслабленной и смотрящей на горизонт на закате.

Стиль

В этом примере показано, как указать стиль.

Стиль	Быстрый	Сгенерированный вывод
Вы можете добавить ключевые слова, чтобы улучшить качество генерации и приблизить ее к предполагаемому стилю, например малая глубина резкости, кадр из фильма, минималистичный, сюрреалистический, винтажный, футуристический или двойная экспозиция.	Стиль фильма-нуар, мужчина и женщина идут по улице, тайна, кинематографичность, черно-белое.

Движение камеры

В этом примере показано, как указать движение камеры.

Движение камеры	Быстрый	Сгенерированный вывод
Варианты движения камеры включают съемку POV, вид с воздуха, вид слежения за дроном или съемку слежения.	Кадр от лица старинной машины, едущей под дождем, Канада ночью, кинематографический вид.

Состав

В этом примере показано, как указать композицию.

Состав	Быстрый	Сгенерированный вывод
Как построен кадр (широкий план, крупный план, низкий ракурс).	Чрезвычайно крупный план глаза с отражением города.
	Создайте широкоформатное видео серфера, идущего по пляжу с доской для серфинга, красивого заката, кинематографического качества.

атмосфера

В этом примере показано, как указать атмосферу.

атмосфера	Быстрый	Сгенерированный вывод
Цветовые палитры играют жизненно важную роль в фотографии, влияя на настроение и передавая желаемые эмоции. Попробуйте такие вещи, как «приглушенные оранжевые теплые тона», «естественный свет», «восход солнца» или «закат». Например, теплая золотая палитра может придать фотографии романтическую и атмосферную атмосферу.	Крупный план девушки, держащей очаровательного щенка золотистого ретривера в парке при солнечном свете.
	Кинематографический снимок грустной женщины, едущей в автобусе под дождем, крупным планом, прохладные голубые тона, грустное настроение.

Используйте эталонные изображения для создания видео

Вы можете оживить изображения, используя функцию преобразования изображения в видео Veo. Вы можете использовать существующие ресурсы или попробовать Imagen создать что-то новое.

Быстрый	Сгенерированный вывод
Зайчик с шоколадной конфеткой.
Зайка убегает.

Негативные подсказки

Отрицательные подсказки могут стать мощным инструментом, помогающим указать элементы, которые вам не нужны в видео. Опишите, что вы хотите запретить модели генерировать после фразы «Отрицательный запрос». Следуйте этим советам:

• ❌ Не используйте поучительные выражения или такие слова, как «нет» или «нет» . Например, «Нет стен» или «Не показывать стены».

• ✅ Опишите то, что вы не хотите видеть. Например, «стена, рамка», что означает, что вам не нужна стена или рамка в видео.

Быстрый	Сгенерированный вывод
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра.
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра. При негативной подсказке – городской фон, рукотворные сооружения, мрачная, грозовая или угрожающая атмосфера.

Соотношения сторон

Генерация видео Gemini Veo поддерживает следующие два соотношения сторон:

Широкоэкранный

Эта подсказка является примером широкоэкранного соотношения сторон 16:9.

Быстрый	Сгенерированный вывод
Создайте видео с изображением человека, управляющего красным кабриолетом в Палм-Спрингс, 1970-е годы, теплый солнечный свет, длинные тени, с помощью дрона слежения.

Портрет

Эта подсказка является примером портретного соотношения сторон 9:16.

Быстрый

Сгенерированный вывод

Создайте видео, демонстрирующее плавное движение величественного гавайского водопада среди пышного тропического леса. Сосредоточьтесь на реалистичном потоке воды, детализированной листве и естественном освещении, чтобы передать спокойствие. Запечатлейте стремительную воду, туманную атмосферу и пятнистый солнечный свет, проникающий сквозь плотный полог. Используйте плавные кинематографические движения камеры, чтобы продемонстрировать водопад и его окрестности. Стремитесь к мирному, реалистичному тону, переносящему зрителя в безмятежную красоту тропического леса Гавайев.

Что дальше

• Получите больше опыта в создании видеороликов с использованием искусственного интеллекта с помощью Veo Colab .

Gemini API обеспечивает доступ к Veo 2 , современной модели создания видео Google. Veo предназначен для того, чтобы помочь вам создавать приложения искусственного интеллекта нового поколения, которые преобразуют пользовательские подсказки и изображения в высококачественные видеоматериалы.

Это руководство поможет вам начать работу с Veo с использованием API Gemini.

О Вео

Veo — самая мощная модель Google для создания видео на сегодняшний день. Он создает видеоролики в широком диапазоне кинематографических и визуальных стилей, улавливая нюансы и последовательно отображая сложные детали в разных кадрах.

Чтобы узнать больше и увидеть пример вывода, ознакомьтесь с обзором Google DeepMind Veo .

Технические характеристики

Видео, созданные Veo, помечаются водяными знаками с помощью SynthID , нашего инструмента для нанесения водяных знаков и идентификации контента, созданного искусственным интеллектом, и проходят через фильтры безопасности и процессы проверки запоминания, которые помогают снизить риски конфиденциальности, авторских прав и предвзятости.

Прежде чем начать

Прежде чем вызывать API Gemini, убедитесь, что выбранный вами SDK установлен, а ключ API Gemini настроен и готов к использованию.

Чтобы использовать Veo с SDK Google Gen AI, убедитесь, что у вас установлена ​​одна из следующих версий:

• Python v1.10.0 или новее
• TypeScript и JavaScript версии 0.8.0 или более поздней версии
• Перейти на версию 1.0.0 или новее

Создание видео

В этом разделе представлены примеры кода для создания видео с помощью текстовых подсказок и изображений .

Создать из текста

Вы можете использовать следующий код для создания видео с помощью Veo:

import time
from google import genai
from google.genai import types

client = genai.Client()  # read API key from GOOGLE_API_KEY

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
    config=types.GenerateVideosConfig(
        person_generation="dont_allow",  # "dont_allow" or "allow_adult"
        aspect_ratio="16:9",  # "16:9" or "9:16"
    ),
)

while not operation.done:
    time.sleep(20)
    operation = client.operations.get(operation)

for n, generated_video in enumerate(operation.response.generated_videos):
    client.files.download(file=generated_video.video)
    generated_video.video.save(f"video{n}.mp4")  # save the video

# Use curl to send a POST request to the predictLongRunning endpoint
# The request body includes the prompt for video generation
curl "${BASE_URL}/models/veo-2.0-generate-001:predictLongRunning?key=${GOOGLE_API_KEY}" \
  -H "Content-Type: application/json" \
  -X "POST" \
  -d '{
    "instances": [{
        "prompt": "Panning wide shot of a calico kitten sleeping in the sunshine"
      }
    ],
    "parameters": {
      "aspectRatio": "16:9",
      "personGeneration": "dont_allow",
    }
  }' | tee result.json | jq .name | sed 's/"//g' > op_name

Выполнение этого кода занимает около 2–3 минут, хотя это может занять больше времени, если ресурсы ограничены. После завершения работы вы должны увидеть видео, которое выглядит примерно так:

Если вместо видео вы видите сообщение об ошибке, это означает, что ресурсы ограничены и ваш запрос не может быть выполнен. В этом случае запустите код еще раз.

Сгенерированные видео хранятся на сервере 2 дня, после чего удаляются. Если вы хотите сохранить локальную копию сгенерированного видео, вам необходимо запустить result() и save() в течение двух дней после создания.

Генерировать из изображений

Вы также можете создавать видео, используя изображения. Следующий код генерирует изображение с помощью Imagen, а затем использует сгенерированное изображение в качестве начального кадра для сгенерированного видео.

Сначала сгенерируйте изображение с помощью Imagen :

prompt="Panning wide shot of a calico kitten sleeping in the sunshine",

imagen = client.models.generate_images(
    model="imagen-3.0-generate-002",
    prompt=prompt,
    config=types.GenerateImagesConfig(
      aspect_ratio="16:9",
      number_of_images=1
    )
)

imagen.generated_images[0].image

Затем сгенерируйте видео, используя полученное изображение в качестве первого кадра:

operation = client.models.generate_videos(
    model="veo-2.0-generate-001",
    prompt=prompt,
    image = imagen.generated_images[0].image,
    config=types.GenerateVideosConfig(
      # person_generation only accepts "dont_allow" for image-to-video
      aspect_ratio="16:9",  # "16:9" or "9:16"
      number_of_videos=2
    ),
)

# Wait for videos to generate
 while not operation.done:
  time.sleep(20)
  operation = client.operations.get(operation)

for n, video in enumerate(operation.response.generated_videos):
    fname = f'with_image_input{n}.mp4'
    print(fname)
    client.files.download(file=video.video)
    video.video.save(fname)

Параметры модели Veo

(Соглашения об именах зависят от языка программирования.)

• prompt : текстовая подсказка для видео. Параметр image , если он присутствует, является необязательным.
• image : изображение, которое будет использоваться в качестве первого кадра видео. Если параметр prompt присутствует, он является необязательным.
• negativePrompt : текстовая строка, описывающая все, что вы хотите запретить модели генерировать.
• aspectRatio : изменяет соотношение сторон создаваемого видео. Поддерживаемые значения: "16:9" и "9:16" . По умолчанию установлено "16:9" .
• personGeneration : разрешить модели создавать видео с людьми. Поддерживаются следующие значения:
  • Генерация текста в видео:
    • "dont_allow" : не разрешать включение людей или лиц.
    • "allow_adult" : создавать видео, в которых участвуют взрослые, но не дети.
  • Генерация изображения в видео:
    • "dont_allow" : значение по умолчанию и единственное значение для создания изображения в видео.
• numberOfVideos : запрошено выходное видео, 1 или 2 .
• durationSeconds : продолжительность каждого выходного видео в секундах, от 5 до 8 .
• enhance_prompt : включить или отключить переписчик подсказок. Включено по умолчанию.

Что стоит попробовать

Чтобы получить максимальную отдачу от Veo, включите в свои подсказки терминологию, специфичную для видео. Veo понимает широкий спектр терминов, связанных с:

• Композиция кадра: укажите кадр и количество объектов в кадре (например, «одиночный снимок», «два кадра», «снимок через плечо»).
• Позиционирование и движение камеры. Управляйте местоположением и движением камеры, используя такие термины, как «уровень глаз», «большой угол», «червячный глаз», «снимок с тележки», «снимок с масштабированием», «панорамный снимок» и «следящий снимок».
• Эффекты фокуса и линзы. Используйте такие термины, как «мелкий фокус», «глубокий фокус», «мягкий фокус», «макрообъектив» и «широкоугольный объектив», чтобы добиться определенных визуальных эффектов.
• Общий стиль и тема: руководите творческим направлением Veo, определяя такие стили, как «научная фантастика», «романтическая комедия», «боевик» или «анимация». Вы также можете описать нужные предметы и фон, например «городской пейзаж», «природа», «транспортные средства» или «животные».

Veo оперативное руководство

В этом разделе руководства Veo содержатся примеры видеороликов, которые вы можете создать с помощью Veo, и показано, как изменять подсказки для получения различных результатов.

Защитные фильтры

Veo применяет фильтры безопасности в Gemini, чтобы гарантировать, что созданные видео и загруженные фотографии не содержат оскорбительного содержания. Подсказки, нарушающие наши условия и правила, блокируются.

Основы написания подсказок

Хорошие подсказки описательны и ясны. Чтобы сгенерированное видео было максимально близко к тому, что вы хотите, начните с определения вашей основной идеи, а затем уточните ее, добавив ключевые слова и модификаторы.

В приглашение должны быть включены следующие элементы:

• Тема : объект, человек, животное или пейзаж, который вы хотите видеть в своем видео.
• Контекст : фон или контекст, в котором находится объект.
• Действие : Что делает субъект (например, идет , бежит или поворачивает голову ).
• Стиль : он может быть общим или очень конкретным. Рассмотрите возможность использования определенных ключевых слов в стиле фильма, например фильма ужасов , фильма нуар , или стилей анимации, например стиля мультфильма .
• Движение камеры : [Необязательно] Что делает камера, например вид сверху , на уровне глаз , снимок сверху или снимок с низкого угла .
• Композиция : [Необязательно] Кадр кадра, например общий план , крупный план или очень крупный план .
• Атмосфера : [Необязательно] Как цвет и свет влияют на сцену, например синие тона , ночные или теплые тона .

Дополнительные советы по написанию подсказок

Следующие советы помогут вам написать подсказки для создания видео:

• Используйте описательный язык : используйте прилагательные и наречия, чтобы нарисовать четкую картину Veo.
• Предоставьте контекст . При необходимости добавьте справочную информацию, которая поможет вашей модели понять, чего вы хотите.
• Ссылайтесь на конкретные художественные стили . Если вы имеете в виду определенную эстетику, ссылайтесь на конкретные художественные стили или художественные направления.
• Используйте инструменты быстрого проектирования . Рассмотрите возможность изучения инструментов или ресурсов быстрого проектирования, которые помогут вам усовершенствовать свои подсказки и достичь оптимальных результатов. Для получения дополнительной информации посетите раздел «Введение в быстрое проектирование» .
• Улучшите детали лица на личных и групповых изображениях . Укажите детали лица в качестве фокуса фотографии, например, используя слово «портрет» в подсказке.

Примеры подсказок и вывода

В этом разделе представлено несколько подсказок, подчеркивающих, как описательные детали могут улучшить результат каждого видео.

сосульки

В этом видеоролике показано, как можно использовать элементы основы написания подсказок в подсказках.

Быстрый	Сгенерированный вывод
Крупным планом (композиция) тающих сосулек (объект) на замерзшей каменной стене (контекст) с холодными синими тонами (атмосфера), увеличенное изображение (движение камеры) с сохранением деталей капель воды крупным планом (действие).

Мужчина по телефону

Эти видеоролики демонстрируют, как вы можете изменить свое приглашение, добавив в него все более конкретные детали, чтобы Veo мог уточнить выходные данные по своему вкусу.

Быстрый	Сгенерированный вывод	Анализ
Камера поворачивается, показывая крупным планом отчаявшегося мужчину в зеленом плаще. Он звонит по вращающемуся настенному телефону с зеленой неоновой лампочкой. Это похоже на сцену из фильма.		Это первое видео, созданное на основе подсказки.
В кинематографическом кадре крупным планом показано, как отчаявшийся мужчина в потертом зеленом плаще набирает номер по дисковому телефону, установленному на шероховатой кирпичной стене, залитой жутким светом зеленой неоновой вывески. Камера приближается, показывая напряжение в его челюсти и отчаяние, отразившееся на его лице, когда он изо всех сил пытается позвонить. Небольшая глубина резкости фокусируется на его нахмуренном лбу и черном дисковом телефоне, размывая фон в море неоновых цветов и нечетких теней, создавая ощущение безотлагательности и изоляции.		Более подробная подсказка приводит к созданию более целенаправленного видео с более богатой средой.
Видео с плавным движением, в котором изображен отчаявшийся мужчина в зеленом плаще, пользующийся старинным дисковым телефоном у стены, залитой жутким зеленым неоновым светом. Камера стартует со среднего расстояния, медленно приближаясь к лицу мужчины, показывая его безумное выражение и пот на лбу, когда он срочно набирает номер телефона. Все внимание сосредоточено на руках мужчины, его пальцы возятся с циферблатом, пока он отчаянно пытается подключиться. Зеленый неоновый свет отбрасывает на стену длинные тени, добавляя напряженности атмосфере. Сцена создана так, чтобы подчеркнуть изоляцию и отчаяние мужчины, подчеркивая резкий контраст между ярким светом неона и мрачной решимостью мужчины.		Добавление большего количества деталей придает объекту реалистичность и создает интенсивную и яркую сцену.

Снежный барс

В этом примере демонстрируется вывод, который Veo может сгенерировать для простого приглашения.

Быстрый	Сгенерированный вывод
Симпатичное существо с мехом, похожим на снежного барса, гуляет по зимнему лесу, 3D-рендеринг в мультяшном стиле.

Бегущий снежный барс

Это приглашение содержит более подробную информацию и демонстрирует сгенерированный результат, который может быть ближе к тому, что вы хотите в своем видео.

Быстрый

Сгенерированный вывод

Создайте короткую 3D-анимационную сцену в веселом мультяшном стиле. Милое существо с мехом, похожим на снежного барса, большими выразительными глазами и дружелюбным округлым телом радостно скачет по причудливому зимнему лесу. В сцене должны быть округлые, покрытые снегом деревья, нежно падающие снежинки и теплый солнечный свет, проникающий сквозь ветви. Подпрыгивающие движения существа и широкая улыбка должны передавать чистый восторг. Стремитесь к оптимистичному, душевному тону с яркими веселыми цветами и игривой анимацией.

Примеры написания элементов

Эти примеры показывают, как уточнить подсказки по каждому базовому элементу.

Предмет

В этом примере показано, как указать описание темы.

Описание предмета	Быстрый	Сгенерированный вывод
Описание может включать предмет или несколько предметов и действий. Здесь наша тема — «белый бетонный жилой дом».	Архитектурная визуализация белого бетонного жилого дома с плавными органическими формами, плавно сочетающимися с пышной зеленью и футуристическими элементами.

Контекст

В этом примере показано, как указать контекст.

Контекст	Быстрый	Сгенерированный вывод
Фон или контекст, в котором будет помещен предмет, очень важен. Попробуйте разместить объект съемки на разных фонах, например, на оживленной улице или в открытом космосе.	Спутник, плывущий в космическом пространстве, на фоне Луны и звезд.

Действие

В этом примере показано, как указать действие.

Действие	Быстрый	Сгенерированный вывод
Что делает субъект: ходит, бежит или поворачивает голову.	Общий план женщины, идущей по пляжу, выглядящей довольной и расслабленной и смотрящей на горизонт на закате.

Стиль

В этом примере показано, как указать стиль.

Стиль	Быстрый	Сгенерированный вывод
Вы можете добавить ключевые слова, чтобы улучшить качество генерации и приблизить ее к предполагаемому стилю, например малая глубина резкости, кадр из фильма, минималистичный, сюрреалистический, винтажный, футуристический или двойная экспозиция.	Стиль фильма-нуар, мужчина и женщина идут по улице, тайна, кинематографичность, черно-белое.

Движение камеры

В этом примере показано, как указать движение камеры.

Движение камеры	Быстрый	Сгенерированный вывод
Варианты движения камеры включают съемку POV, вид с воздуха, вид слежения за дроном или съемку слежения.	Кадр от лица старинной машины, едущей под дождем, Канада ночью, кинематографический вид.

Состав

В этом примере показано, как указать композицию.

Состав	Быстрый	Сгенерированный вывод
Как построен кадр (широкий план, крупный план, низкий ракурс).	Чрезвычайно крупный план глаза с отражением города.
	Создайте широкоформатное видео серфера, идущего по пляжу с доской для серфинга, красивого заката, кинематографического качества.

атмосфера

В этом примере показано, как указать атмосферу.

атмосфера	Быстрый	Сгенерированный вывод
Цветовые палитры играют жизненно важную роль в фотографии, влияя на настроение и передавая желаемые эмоции. Попробуйте такие вещи, как «приглушенные оранжевые теплые тона», «естественный свет», «восход солнца» или «закат». Например, теплая золотая палитра может придать фотографии романтическую и атмосферную атмосферу.	Крупный план девушки, держащей очаровательного щенка золотистого ретривера в парке при солнечном свете.
	Кинематографический снимок грустной женщины, едущей в автобусе под дождем, крупным планом, прохладные голубые тона, грустное настроение.

Используйте эталонные изображения для создания видео

Вы можете оживить изображения, используя функцию преобразования изображения в видео Veo. Вы можете использовать существующие ресурсы или попробовать Imagen создать что-то новое.

Быстрый	Сгенерированный вывод
Зайчик с шоколадной конфеткой.
Зайка убегает.

Негативные подсказки

Отрицательные подсказки могут стать мощным инструментом, помогающим указать элементы, которые вам не нужны в видео. Опишите, что вы хотите запретить модели генерировать после фразы «Отрицательный запрос». Следуйте этим советам:

• ❌ Не используйте поучительные выражения или такие слова, как «нет» или «нет» . Например, «Нет стен» или «Не показывать стены».

• ✅ Опишите то, что вы не хотите видеть. Например, «стена, рамка», что означает, что вам не нужна стена или рамка в видео.

Быстрый	Сгенерированный вывод
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра.
Создайте короткую стилизованную анимацию большого одинокого дуба с энергично развевающимися на сильном ветру листьями. Дерево должно иметь слегка утрированную, причудливую форму, с динамичными, струящимися ветвями. Листья должны проявлять разнообразные осенние цвета, кружиться и танцевать на ветру. В анимации должна использоваться теплая, привлекательная цветовая палитра. При негативной подсказке – городской фон, рукотворные сооружения, мрачная, грозовая или угрожающая атмосфера.

Соотношения сторон

Генерация видео Gemini Veo поддерживает следующие два соотношения сторон:

Широкоэкранный

Эта подсказка является примером широкоэкранного соотношения сторон 16:9.

Быстрый	Сгенерированный вывод
Создайте видео с изображением человека, управляющего красным кабриолетом в Палм-Спрингс, 1970-е годы, теплый солнечный свет, длинные тени, с помощью дрона слежения.

Портрет

Эта подсказка является примером портретного соотношения сторон 9:16.

Быстрый

Сгенерированный вывод

Создайте видео, демонстрирующее плавное движение величественного гавайского водопада среди пышного тропического леса. Сосредоточьтесь на реалистичном потоке воды, детализированной листве и естественном освещении, чтобы передать спокойствие. Запечатлейте стремительную воду, туманную атмосферу и пятнистый солнечный свет, проникающий сквозь плотный полог. Используйте плавные кинематографические движения камеры, чтобы продемонстрировать водопад и его окрестности. Стремитесь к мирному, реалистичному тону, переносящему зрителя в безмятежную красоту тропического леса Гавайев.

Что дальше

• Получите больше опыта в создании видеороликов с использованием искусственного интеллекта с помощью Veo Colab .