Gemini Omni Flash 視頻生成

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": "一支藍色按壓瓶在純白攝影棚中輕微轉動，商業產品視頻",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini-omni-flash-preview-official",
  "status": "queued",
  "created_at": 1779247407
}

POST

videos

generations

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": "一支藍色按壓瓶在純白攝影棚中輕微轉動，商業產品視頻",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini-omni-flash-preview-official",
  "status": "queued",
  "created_at": 1779247407
}

通過 model 指定 gemini-omni-flash-preview-official
支持文生視頻、圖像/參考圖生視頻和視頻編輯
最多支持 10 張參考圖或 3 個輸入視頻；圖片與視頻不能混用
視頻最長 10 秒；Playground 提供 4 / 6 / 8 / 10 秒預設
僅支持 720p 分辨率；支持 16:9 和 9:16 畫幅
異步任務接口，提交後使用任務 ID 查詢結果

本文檔僅適用於 gemini-omni-flash-preview-official。平台通過 Vertex AI Interactions API 調用它（使用 Service Account OAuth），而不是 Vertex AI Publisher Model 的 predictLongRunning 接口。它與舊版 gemini-omni-flash / gemini_omni_flash 是兩個獨立模型。

請先通過圖片上傳 API上傳本地圖片，通過視頻上傳 API上傳本地視頻，再傳入返回的 URL。不要直接傳 base64 媒體數據。

Authorizations

string

必填

使用 Bearer Token 認證：

Authorization: Bearer YOUR_API_KEY

Body

string

預設值:"gemini-omni-flash-preview-official"

必填

模型名稱。使用 gemini-omni-flash-preview-official。

string

必填

視頻生成提示詞。

integer

預設值:"6"

視頻時長（秒），最大爲 10。Playground 提供 4、6、8、10 秒預設。

string

預設值:"16:9"

視頻比例，支持：

16:9 橫屏
9:16 豎屏

string

預設值:"720p"

視頻分辨率：

720p 默認分辨率
僅支持 720p，不接受 Veo 專屬參數

string[]

可選的參考圖 URL 數組，最多 10 張。不傳時爲文生視頻。不能與 video_list 同時使用。

可選的視頻編輯輸入，最多 3 個。每一項必須包含 video_url，例如 { "video_url": "https://example.com/input.mp4" }。支持 HTTPS URL、data URI 和平台上傳後返回的視頻 URL；後端下載的單個輸入視頻最大 50 MB。不能與 image_urls 同時使用。

object

可選的 Interactions 生成參數。支持 temperature（0.0–2.0）、topP / top_p（0.0–1.0）、candidateCount / candidate_count、previous_interaction_id，以及 task（text_to_video、image_to_video、reference_to_video 或 edit）。省略 task 時，平臺不會擅自預設；由上游根據 prompt 與媒體推斷。對 edit（或帶參考影片且未明確指定非 edit 任務）路徑，平臺會省略 aspect_ratio，因為上游拒絕在 edit 的 response_format 中設定長寬比。

Response

string

任務 ID，用於查詢任務狀態。

string

對象類型，通常爲 generation.task。

string

使用的模型名稱。

string

任務狀態：queued、in_progress、completed、failed。

integer

任務創建時間戳。

string

任務完成後的生成視頻 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": "一支藍色按壓瓶在純白攝影棚中輕微轉動，商業產品視頻",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini-omni-flash-preview-official",
  "status": "queued",
  "created_at": 1779247407
}

查詢任務

提交接口會返回任務 ID。使用通用視頻任務查詢接口獲取狀態和結果：

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

概覽

快速上手

文本對話系列

圖像系列

視頻系列

任務管理

文件上傳

賬戶

常見問題

Authorizations

Body

Response

Examples

查詢任務

​Authorizations

​Body

​Response

​Examples

​查詢任務

Authorizations

Body

Response

Examples

查詢任務