Gemini Omni Video

Gemini Omni Video — мультимодальная модель генерации видео от Google DeepMind. Поддерживает text-to-video, image-to-video (анимация изображения) и video-to-video (редактирование существующего ролика), разрешения 720p / 1080p / 4K, длительность 4 / 6 / 8 / 10 сек.

Полная документация API: Генерация медиа

Обзор

Характеристика	Значение
ID модели	`gemini-omni-video`
prompt	Текстовое описание желаемого видео
aspect_ratio	`16:9`, `9:16`
resolution	`720p`, `1080p`, `4k`
duration	`4`, `6`, `8`, `10` (секунды)
images	Массив референсных изображений (image-to-video)
videos	Массив исходных видео (video-to-video)
async	`true` (асинхронная генерация)

Режимы работы

Text-to-Video
Image-to-Video
Video-to-Video

Только текстовый промпт — модель генерирует ролик с нуля.

{
  "model": "gemini-omni-video",
  "input": {
    "prompt": "человек скачет на лошади по степи",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "6"
  },
  "async": true
}

Анимация статичного изображения. Промпт описывает, что должно произойти.

{
  "model": "gemini-omni-video",
  "input": {
    "prompt": "Анимируй логотип: лёгкое вращение и мягкое свечение",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": "6",
    "images": [
      {
        "type": "url",
        "data": "https://example.com/example.png"
      }
    ]
  },
  "async": true
}

Редактирование существующего видео — например, добавление динамики, смена стиля или доработка движения.

{
  "model": "gemini-omni-video",
  "input": {
    "prompt": "Добавь динамичности в видео",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "6",
    "videos": [
      {
        "type": "url",
        "data": "https://example.com/example.mp4"
      }
    ]
  },
  "async": true
}

Параметры

Параметр	Тип	Обязательный	Описание
`model`	string	Да	`gemini-omni-video`
`prompt`	string	Да	Текстовое описание желаемого видео
`aspect_ratio`	string	Нет	`16:9`, `9:16`
`resolution`	string	Нет	`720p`, `1080p`, `4k`
`duration`	string	Нет	`4`, `6`, `8`, `10` (секунды)
`images`	array	Нет	Референсные изображения для image-to-video: `[{ "type": "url", "data": "..." }]`
`videos`	array	Нет	Исходные видео для video-to-video: `[{ "type": "url", "data": "..." }]`
`async`	bool	Нет	Запустить генерацию асинхронно. По умолчанию `true`

Параметр async: true — обязателен для всех запросов: генерация видео возвращает id сразу, а готовый ролик приходит позже.

Пример запроса (cURL)

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-video",
    "input": {
      "prompt": "человек скачет на лошади по степи",
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "duration": "6"
    },
    "async": true
  }'

Асинхронная генерация

Генерация видео — асинхронный процесс. После отправки запроса вы получите id, который нужно использовать для проверки статуса:

Отправка запроса

POST на /api/v1/media возвращает id генерации

Проверка статуса

GET на /api/v1/media/{id} возвращает текущий статус

Получение результата

Когда статус completed, в ответе будет URL готового видео

Советы и лучшие практики

Описывайте движение

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

Следите за duration и разрешением

Большие значения duration (8–10 сек) и 4k заметно увеличивают время и стоимость генерации. Для тестов используйте 720p + duration: 4.

Передавайте файлы по URL

images[] и videos[] принимают публичные URL в формате { "type": "url", "data": "https://..." }. Для приватных файлов сначала загрузите их через /v1/storage/upload (см. Хранилище файлов).

video-to-video — для доработок

Если нужно не генерировать с нуля, а подправить существующий ролик (добавить эффект, изменить темп, сменить стиль) — используйте режим video-to-video через videos[].

Начало работы

Продвинутое

Генерация медиа

Интеграции

Gemini Omni Video

Обзор

Режимы работы

Параметры

Пример запроса (cURL)

Асинхронная генерация

Советы и лучшие практики

Следующие шаги

Статус генерации

Хранилище файлов

​Обзор

​Режимы работы

​Параметры

​Пример запроса (cURL)

​Асинхронная генерация

​Советы и лучшие практики

​Следующие шаги

Статус генерации

Хранилище файлов

Обзор

Режимы работы

Параметры

Пример запроса (cURL)

Асинхронная генерация

Советы и лучшие практики

Следующие шаги