Полная документация 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 | 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)
Асинхронная генерация
Генерация видео — асинхронный процесс. После отправки запроса вы получитеid, который нужно использовать для проверки статуса:
Советы и лучшие практики
Описывайте движение
Описывайте движение
В промпте явно указывайте, что должно двигаться: «камера приближается», «объект вращается», «человек бежит». Без этого модель может выдать статичную сцену.
Следите за duration и разрешением
Следите за duration и разрешением
Большие значения
duration (8–10 сек) и 4k заметно увеличивают время и стоимость генерации. Для тестов используйте 720p + duration: 4.Передавайте файлы по URL
Передавайте файлы по URL
images[] и videos[] принимают публичные URL в формате { "type": "url", "data": "https://..." }. Для приватных файлов сначала загрузите их через /v1/storage/upload (см. Хранилище файлов).video-to-video — для доработок
video-to-video — для доработок
Если нужно не генерировать с нуля, а подправить существующий ролик (добавить эффект, изменить темп, сменить стиль) — используйте режим video-to-video через
videos[].Следующие шаги
Статус генерации
Проверка статуса генерации медиа
Хранилище файлов
Загрузка изображений и видео