Генерация видео Gemini Omni Flash
Генерация и редактирование видео Gemini Omni Flash с текстом, до 10 референсных изображений или до 3 входных видео
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
- Укажите
gemini-omni-flash-preview-officialв полеmodel - Поддерживает text-to-video, image/reference-to-video и редактирование видео
- Поддерживает до 10 референсных изображений и до 3 входных видео; изображения и видео можно передавать вместе в одном запросе
- Максимальная длительность видео — 10 секунд; в Playground доступны пресеты 4 / 6 / 8 / 10 секунд
- Поддерживается только разрешение
720p; доступны форматы16:9и9:16 - Асинхронный API задач: после отправки используйте ID задачи для проверки статуса
Эта страница описывает gemini-omni-flash-preview-official. Платформа вызывает её через Vertex AI Interactions API, а не через Vertex AI Publisher Model predictLongRunning.
Сначала загрузите локальные изображения через Upload Image API, а видео через Upload Video API, затем передайте полученные URL. Не передавайте media в base64 напрямую.
Authorizations
AuthorizationstringзаголовокобязательноИспользуйте Bearer Token:
Authorization: Bearer YOUR_API_KEYBody
modelstringтелообязательнопо умолчанию: gemini-omni-flash-preview-officialНазвание модели. Используйте gemini-omni-flash-preview-official.
promptstringтелообязательноТекстовый prompt для генерации видео.
durationintegerтелопо умолчанию: 6Длительность видео в секундах. Максимум — 10; в Playground доступны пресеты 4, 6, 8, 10.
aspect_ratiostringтелопо умолчанию: 16:9Соотношение сторон:
16:9landscape9:16portrait
resolutionstringтелопо умолчанию: 720pРазрешение видео:
720pпо умолчанию- Поддерживается только
720p; параметры Veo не принимаются
image_urlsstring[]телоНеобязательный массив URL референсных изображений, до 10 элементов. Не передавайте его для text-to-video. Можно совмещать с video_list, например чтобы приложить референсные изображения при продлении видео.
video_listobject[]телоНеобязательные входные видео для редактирования, до 3 элементов. Каждый объект должен содержать video_url. Можно совмещать с image_urls для смешанного ввода «видео + референсные изображения».
metadataobjectтелоНеобязательные параметры генерации: temperature, topP / top_p, candidateCount / candidate_count, previous_interaction_id и task (text_to_video, image_to_video, reference_to_video, edit или extend). extend продолжает исходное видео, переданное через video_list, несовместим с previous_interaction_id и также не передает aspect_ratio.
Response
idstringID задачи для проверки статуса.
objectstringТип объекта, обычно generation.task.
modelstringНазвание модели, использованной в запросе.
statusstringСтатус задачи: queued, in_progress, completed, failed.
created_atintegerВременная метка создания задачи.
video_urlstringURL сгенерированного видео после завершения задачи.
Examples
Пример запроса
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "Синяя бутылка с помпой медленно вращается в белой студии, коммерческое product video",
"duration": 6,
"aspect_ratio": "9:16",
"resolution": "720p",
"image_urls": ["https://example.com/reference.jpg"]
}'Пример продления видео (duration — длина продления в секундах, при отсутствии около 10; результат — исходное видео с продолжением):
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-flash-preview-official",
"prompt": "Continue the same scene and camera motion",
"duration": 5,
"video_list": [{"video_url": "https://example.com/input.mp4"}],
"metadata": {"task": "extend"}
}'Пример ответа
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}Query Task
Эндпоинт генерации возвращает ID задачи. Используйте общий эндпоинт статуса видео, чтобы получить статус и результат:
curl --request GET \
--url https://toapis.com/v1/videos/generations/{task_id} \
--header "Authorization: Bearer YOUR_API_KEY"