Skip to main content
POST

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

string
обязательно
Все запросы требуют аутентификации по Bearer Token.Получение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключ.При выполнении запросов добавляйте в заголовок:

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

string
обязательно
Название модели генерации видео, фиксированное значение gemini-omni-flash-preview.
string
обязательно
Текстовая инструкция. Для Text-to-Video — описание сцены; для Image/Video-to-Video — инструкция по движению / стилю / редактированию.
prompt и референсные материалы (image_urls / video_urls) — необходимо предоставить хотя бы одно из них.
array<string>
Референсные изображения, максимум 16 штук. Каждый элемент — URL вида http(s)://.Поддерживаются JPEG / PNG. Для нескольких субъектов (например, «кошка + клубок ниток») можно передать несколько изображений и описать в prompt, как они взаимодействуют.
array<string>
Референсное / редактируемое видео, максимум 1 (несколько видеоссылок не поддерживаются). Может быть прямой ссылкой http(s):// или data:video/....
  • Референсное видео 1 ~ 24 секунды, официально рекомендуется ≤3 секунд.
  • video_urls и extend_from_task_id взаимоисключающие; укажите только один из них, нельзя передавать оба одновременно.
string
по умолчанию:"16:9"
Соотношение сторон видео, реально управляет ориентацией выводимого кадра.
При передаче video_urls параметр aspect_ratio не применяется.
Поддерживаются только:
  • 16:9 - горизонтальное (по умолчанию)
  • 9:16 - вертикальное
Другие значения обрабатываются как 16:9.
string
по умолчанию:"720p"
Разрешение видео. В настоящее время поддерживается только 720p.
string
Идентификатор предыдущей задачи: укажите ** task_id** предыдущей задачи генерации.
extend_from_task_id и video_urls взаимоисключающие; укажите только один из них, нельзя передавать оба одновременно.

Ответ

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

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

Генерация видео является асинхронной задачей. После отправки возвращается task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результат генерации.

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

Сценарии использования

Сценарий 1: Text-to-Video

Сценарий 2: Image-to-Video

Сценарий 3: Video-to-Video