ToAPIsToAPIs
Gemini Omni Official

Генерация видео Gemini Omni Flash

Генерация и редактирование видео Gemini Omni Flash с текстом, до 10 референсных изображений или до 3 входных видео

POST
/v1/videos/generations

Для пользователей из материкового Китая: используйте 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_KEY

Body

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:9 landscape
  • 9:16 portrait
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

idstring

ID задачи для проверки статуса.

objectstring

Тип объекта, обычно generation.task.

modelstring

Название модели, использованной в запросе.

statusstring

Статус задачи: queued, in_progress, completed, failed.

created_atinteger

Временная метка создания задачи.

video_urlstring

URL сгенерированного видео после завершения задачи.

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"