Skip to main content
POST

Аутентификация

string
обязательно
Для всех API требуется аутентификация с помощью Bearer Token.Получение API-ключа:Получите API-ключ на странице управления API-ключами.Добавьте его в заголовок запроса:

Параметры запроса

string
обязательно
Название модели генерации видео. Допустимо только gemini-omni-1.1-flash.
string
Текстовая инструкция. Для генерации из текста опишите сцену; для генерации из изображения, редактирования или продолжения видео опишите движение, стиль или нужное изменение.
Укажите хотя бы одно: prompt или медиаматериалы (image_urls, изображения первого/последнего кадров либо video_urls).
string
по умолчанию:"720p"
Разрешение выходного видео. Регистр не учитывается.Допустимые значения:
  • 360p
  • 720p (по умолчанию)
  • 1080p
  • 4k
2160p обрабатывается как 4k. Разрешение определяет уровень предварительного списания и основную стоимость вывода видео.
Неподдерживаемое разрешение приводит к ошибке invalid_resolution.
string
по умолчанию:"16:9"
Соотношение сторон видео для альбомной или портретной ориентации.Поддерживается:
  • 16:9 — альбомная ориентация (по умолчанию)
  • 9:16 — портретная ориентация
Другие значения обрабатываются как 16:9.
При передаче video_urls выход обычно сохраняет соотношение сторон исходного видео, поэтому aspect_ratio может не применяться.
array<string>
Массив референсных изображений. Поддерживаются только общедоступные HTTP/HTTPS URL.
  • 1 изображение: по умолчанию используется как начальный кадр видео
  • Несколько изображений: используются как референсы объектов или стиля; опишите назначение и взаимосвязь изображений в prompt
В image_urls и изображениях первого/последнего кадров суммарно допускается не более 10 изображений.
string
Изображение первого кадра. Поддерживается только общедоступный HTTP/HTTPS URL.
  • Передано отдельно: изображение используется как начальный кадр видео
  • Передано вместе с last_frame_image: создается видео с плавным переходом от первого кадра к последнему
string
Изображение последнего кадра. Поддерживается только общедоступный HTTP/HTTPS URL; его необходимо передавать вместе с first_frame_image.
Если передать только last_frame_image, вернется ошибка invalid_frame_images. Рекомендуется использовать одинаковое соотношение сторон для обоих кадров и согласовать его с aspect_ratio.
Для первого кадра или пары первого и последнего кадров следующие способы равнозначны. Выберите один и не передавайте оба одновременно:
  • Используйте first_frame_image / last_frame_image
  • Используйте image_with_roles и задайте role как first_frame / last_frame
array<object>
Массив изображений с ролями. Это эквивалентная альтернатива first_frame_image / last_frame_image, которая также позволяет задавать референсные изображения.Пример:
Если также передан image_urls, референсы берутся из image_urls и не объединяются с референсами в image_with_roles. Общее число фактически используемых изображений, включая первый и последний кадры, не должно превышать 10.
array<string>
Массив видео для редактирования или продолжения. Сейчас допускается не более одного видео длительностью до 10 секунд.Поддерживаются только общедоступные прямые HTTP/HTTPS ссылки на видео. Ссылки YouTube не поддерживаются.
video_urls и extend_from_task_id взаимоисключающие. Укажите только одно из них.
object
Объект дополнительных параметров для явного указания цели генерации.
При интерполяции первого и последнего кадров модель определяет тип задачи автоматически, а платформа не передает metadata.task.
string
Локальный task_id предыдущей задачи генерации. Используется для диалогового редактирования или дальнейшего продолжения без повторной загрузки предыдущего видео.Указанная задача должна принадлежать текущему пользователю, быть успешно завершена и относиться к модели Gemini Omni.
extend_from_task_id и video_urls взаимоисключающие. Укажите только одно из них.
У модели нет параметра duration. Длительность каждого результата определяется моделью автоматически и обычно составляет 3–10 секунд. Для управления темпом опишите его в prompt естественным языком или временными интервалами.

Ответ

integer
Код ответа. При успехе — 200.
array
Возвращаемый массив задач.

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

Генерация видео выполняется асинхронно. После получения task_id используйте API получения статуса задачи, чтобы запросить прогресс и результат.
cURL
Опрашивайте задачу каждые 5–10 секунд и остановитесь при статусе completed или failed. Рекомендуемый общий тайм-аут клиента — 10 минут.

Пример успешного результата

Примеры использования

Пример 1: генерация видео из текста (4K)

Пример 2: интерполяция первого и последнего кадров

Пример 3: референсы нескольких объектов

Пример 4: первый и последний кадры через роли изображений

Пример 5: редактирование видео

Для редактирования видео используйте короткие и точные промпты. Если нужно изменить только одну часть, добавьте Keep everything else the same, чтобы сохранить остальное без изменений.

Пример 6: диалоговое продолжение