跳轉到主要內容
POST
/
v1
/
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",
    "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",
  "status": "queued",
  "created_at": 1779247407
}
  • 通過 model 指定 gemini_omni_flash
  • 支持文生視頻、單圖生視頻，以及 3 張參考圖融合
  • 支持 4 / 6 / 10 秒時長
  • 默認 720P；1080p 爲橫屏 1080P，僅支持 16:9
  • 異步任務接口，提交後使用任務 ID 查詢結果
請先通過圖片上傳 API 上傳本地圖片，再把返回的 URL 放入 image_urls。不要直接傳 base64 圖片。

​
Authorizations

​
Authorization
string
必填
使用 Bearer Token 認證：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
預設值:"gemini_omni_flash"
必填
模型名稱。使用 gemini_omni_flash。
​
prompt
string
必填
視頻生成提示詞。
​
duration
integer
預設值:"6"
視頻時長，支持 4、6、10。
​
aspect_ratio
string
預設值:"16:9"
視頻比例，支持：
  • 16:9 橫屏
  • 9:16 豎屏
​
resolution
string
預設值:"720P"
視頻分辨率：
  • 720P 默認分辨率
  • 1080p 橫屏 1080P，僅支持 aspect_ratio: "16:9"
​
image_urls
string[]
參考圖 URL 數組，可選。僅支持以下三種情況：
  • 不傳或傳空數組：文生視頻
  • 1 張圖片：單圖生視頻
  • 3 張圖片：參考圖融合
不支持傳 2 張圖片。後端會將 image_urls 規範化爲上游參考圖參數。

​
Response

​
id
string
任務 ID，用於查詢任務狀態。
​
object
string
對象類型，通常爲 generation.task。
​
model
string
使用的模型名稱。
​
status
string
任務狀態：queued、in_progress、completed、failed。
​
created_at
integer
任務創建時間戳。
​
video_url
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",
    "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",
  "status": "queued",
  "created_at": 1779247407
}

​
查詢任務

提交接口會返回任務 ID。使用通用視頻任務查詢接口獲取狀態和結果： 
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"