Skip to main content
POST
/
v1
/
video
/
generations
curl --request POST \
  --url https://api.mixroute.ai/v1/video/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "清晨陽光灑在賽博城市的高樓群，鏡頭慢慢推進",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "generateAudio": false
  }'

{
  "task_id": "task_xxx",
  "status": "pending",
  "created_at": 1709459123
}

​
簡介

Veo 是 Google Vertex AI 推出的多模態視訊生成模型，支援 文生視訊（T2V）、 首幀約束 與 首尾幀約束（僅 3.1 系列）生成連貫視訊。透過 MixRoute 視訊 API 呼叫：先 提交任務 取得 task_id，再 查詢任務 輪詢狀態並取得結果。

​
認證

Bearer Token，如 Bearer sk-xxxxxxxxxx

​
支援的模型

模型 ID說明
veo-3.0-fast-generate-001文生視訊、首幀模式，快速版（預設含音訊）
veo-3.1-fast-generate-preview文生視訊、首幀/首尾幀模式，快速版
veo-3.0-generate-preview文生視訊、首幀模式
veo-3.1-generate-preview文生視訊、首幀/首尾幀模式

​
呼叫流程

  1. 提交任務：POST /v1/video/generations，傳入 model、prompt 及 Veo 專用參數。
  2. 輪詢狀態：GET /v1/video/generations/{task_id}，直到 status 為 succeeded 或 failed。
  3. 取得結果：成功時回應中的 url 為視訊資料（Veo 可能為 data:video/mp4;base64,... 或 OSS 連結）。

​
Veo 專用參數

​
prompt
string
required
視訊生成提示詞，描述畫面與動作。
​
durationSeconds
integer
視訊時長（秒），支援：4、6、8。
​
aspectRatio
string
寬高比，僅支援：16:9、9:16。
​
resolution
string
解析度：720p、1080p。
​
image
string
首幀參考圖（URL 或 Base64），用於圖生視訊/首幀約束。
​
lastFrameImage
string
尾幀參考圖（僅 veo-3.1 系列支援），與首幀配合實現首尾幀約束。
​
generateAudio
boolean
是否生成同步音訊。快速版模型會忽略該參數並始終包含音訊。
​
sampleCount
integer
每次生成的視訊數量，範圍 1-4。
更多參數（如 personGeneration、addWatermark、seed）見 提交視訊任務。

​
請求範例

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "清晨陽光灑在賽博城市的高樓群，鏡頭慢慢推進",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "generateAudio": false
  }'
完整請求/回應說明與多模型對比請參見 提交視訊任務 與 查詢視訊任務。 
curl --request POST \
  --url https://api.mixroute.ai/v1/video/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "清晨陽光灑在賽博城市的高樓群，鏡頭慢慢推進",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "generateAudio": false
  }'

{
  "task_id": "task_xxx",
  "status": "pending",
  "created_at": 1709459123
}