ToAPIsToAPIs
Gemini Omni Official

Gemini Omni Flash 動画生成

Gemini Omni Flash でテキスト、最大 10 枚の参照画像、または最大 3 本の入力動画から動画を生成・編集

POST
/v1/videos/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • Use gemini-omni-flash-preview-official in the model field
  • Supports text-to-video, image/reference-to-video, and video editing
  • Supports up to 10 reference images and up to 3 input videos; images and videos can be combined in one request
  • Video duration is limited to 10 seconds; the Playground offers 4 / 6 / 8 / 10 second presets
  • Only 720p resolution is supported; both 16:9 and 9:16 aspect ratios are available
  • Async task API: submit a task, then query by task ID

This page documents gemini-omni-flash-preview-official. The platform routes it through the Vertex AI Interactions API, not the Vertex AI Publisher Model predictLongRunning endpoint.

Upload local images with the Upload 画像API and local videos with the Upload Video API first, then pass the returned URLs. Do not pass base64 media data directly.

Authorizations

Authorizationstringヘッダー必須

Use Bearer Token authentication:

Authorization: Bearer YOUR_API_KEY

Body

modelstringボディ必須デフォルト: gemini-omni-flash-preview-official

モデル name. Use gemini-omni-flash-preview-official.

promptstringボディ必須

Text prompt for video generation.

durationintegerボディデフォルト: 6

Video duration in seconds. The maximum is 10; the Playground offers 4, 6, 8, and 10 second presets.

aspect_ratiostringボディデフォルト: 16:9

Video aspect ratio:

  • 16:9 landscape
  • 9:16 portrait
resolutionstringボディデフォルト: 720p

Video resolution:

  • 720p default resolution
  • Only 720p is supported; Veo-specific parameters are not accepted
image_urlsstring[]ボディ

Optional reference image URL array with up to 10 items. Omit it for text-to-video. Can be combined with video_list, for example to attach reference images when extending a video.

video_listobject[]ボディ

Optional input videos for video editing, with up to 3 items. Each object must contain video_url. Can be combined with image_urls for mixed image-plus-video input.

metadataobjectボディ

Optional generation controls: temperature, topP / top_p, candidateCount / candidate_count, previous_interaction_id, and task (text_to_video, image_to_video, reference_to_video, edit, or extend). extend continues a source video supplied through video_list, cannot be combined with previous_interaction_id, and omits aspect_ratio.

レスポンス

idstring

Task ID for status polling.

objectstring

Object type, usually generation.task.

modelstring

モデル name used for the request.

statusstring

Task status: queued, in_progress, completed, or failed.

created_atinteger

Task creation timestamp.

video_urlstring

Generated video URL when the task completes.

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": "A blue pump bottle slowly rotates in a clean white studio, commercial product video",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

Video extension example (duration is the continuation length in seconds, about 10 when omitted; the output is the source video plus the continuation):

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

The generation endpoint returns a task ID. Use the common video task status endpoint to fetch status and results:

curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"