Google 影片 API 規範

本頁是 Google 影片模型 veo-3.1、veo-3.1-fast、gemini-omni-flash、gemini-omni-flash-1.1 的呼叫規範。這些模型與其他影片模型共用 POST /v1/videos 建立、GET /v1/videos/{id} 輪詢的流程；驗證、素材上傳、輪詢狀態、結果下載與錯誤處理請見影片 API 完整呼叫規範，本頁只列出 Google 影片專屬的欄位與規則。

更新於 2026-10-10。Google 影片模型的新請求一律使用輪詢，請勿設定 callback_url。

模型一覽

通用規則

• 比例：ratio（或 aspect_ratio）只支援 16:9 與 9:16，預設為 16:9。
• 解析度：resolution 可為 720p、1080p 或 4k，預設為 720p。請求 360p 時會以 720P 生成並計費。
• size：可用單一欄位同時指定解析度與比例，例如 1280x720、1080x1920、3840x2160；也可以只寫比例 16:9 或 9:16。size、ratio、resolution 的值互相矛盾時會回傳 400。
• 數量：每次請求生成 1 支影片，n 只能為 1。
• 圖片：每張不超過 20 MiB，可任選下列一種形式：
  • 公開的 HTTPS 連結（建議）；
  • Data URI，例如 data:image/png;base64,...；
  • 不帶前綴的 PNG、JPEG 或 WebP Base64；
  • multipart/form-data 檔案，欄位名稱可用 input_reference、image、images、first_frame、last_frame。
• 圖片格式：Veo 只接受 JPEG 與 PNG；Gemini Omni 接受 PNG、JPEG 與 WebP。
• 影片：只接受公開的 HTTPS 連結，格式為 MP4、MOV 或 WebM，不超過 64 MiB。本機影片請依本機素材上傳先上傳，再把回傳的 url 填入 video；不接受影片的 Data URI、Base64 或 multipart 影片檔。
• 參考影片欄位：使用頂層 video 或 videos，不使用 metadata.referenceVideos。Google 影片模型都不支援參考音訊。
• 結果：完成後的 video_url 是 assets.88api.ai 上的 MP4 網址，可以直接下載，也可以作為下一次延長或編輯請求的 video。

Veo 3.1 / Veo 3.1 Fast

• metadata.video_mode 可明確選擇 frames（首影格或首尾影格）或 reference（參考圖）。也可以用 task 指定 text_to_video、image_to_video、reference_to_video 或 extend；兩者衝突時回傳 400。
• generate_audio（或 metadata.generateAudio）預設為 true，會生成原生同步音訊；設為 false 時成品不帶音軌。是否生成音訊不影響價格。
• negative_prompt（2000 字以內）與 seed（0–4294967295）可寫在頂層，也可寫成 metadata.negativePrompt、metadata.seed。
• 影片延長的輸入須為 1–30 秒的 MP4，依「成品時長 − 輸入時長」的新增秒數計費。
• Veo 不支援參考影片、參考音訊、temperature 與 top_p。

4K 文字生成影片：

{
  "model": "veo-3.1",
  "prompt": "雨夜城市中的銀色跑車，低角度跟拍，霓虹倒影，電影感",
  "duration": 8,
  "resolution": "4k",
  "ratio": "16:9",
  "generate_audio": true
}

首尾影格（兩張圖依序為首影格、尾影格）：

{
  "model": "veo-3.1-fast",
  "prompt": "從清晨空曠的廣場平順轉場到夜晚燈火亮起的同一構圖",
  "duration": 6,
  "size": "1920x1080",
  "images": [
    "https://cdn.example.com/start.jpg",
    "https://cdn.example.com/end.jpg"
  ],
  "metadata": {
    "negativePrompt": "blur, distortion"
  }
}

參考圖（固定 8 秒）：

{
  "model": "veo-3.1",
  "prompt": "保持參考圖中人物的臉部與服裝，在海邊緩步行走",
  "duration": 8,
  "images": [
    "https://cdn.example.com/character-front.jpg",
    "https://cdn.example.com/character-side.jpg"
  ],
  "metadata": {
    "video_mode": "reference"
  }
}

影片延長：

{
  "model": "veo-3.1",
  "prompt": "延續目前的鏡頭，人物繼續往前走",
  "task": "extend",
  "video": "https://assets.88api.ai/media/task-videos/2026/10/example.mp4"
}

上傳本機圖片作為首影格（metadata 以 JSON 字串提交）：

curl --request POST 'https://api.88api.ai/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --form 'model=veo-3.1-fast' \
  --form 'prompt=鏡頭緩緩推近，背景雲層自然移動' \
  --form 'seconds=8' \
  --form 'size=1280x720' \
  --form 'metadata={"video_mode":"frames"}' \
  --form 'input_reference=@start.jpg;type=image/jpeg'

Gemini Omni Flash / Gemini Omni 1.1

未傳 task 時，依提交的素材決定任務：

• 也可以用 task 明確指定 text_to_video、image_to_video、reference_to_video、edit 或 extend。
• 與 Veo 不同：放在 images 中的兩張圖片會被當作參考圖；需要首尾影格時，請使用 first_frame 與 last_frame。
• 首尾影格欄位不能與一般參考圖混用。
• gemini-omni-flash 只輸出 720P，不支援影片編輯與影片延長；參考影片須與參考圖一起提交。
• gemini-omni-flash-1.1 最多接受 10 張參考圖與 3 段參考影片。
• 影片編輯（1.1）：video 放 1 段影片，並在提示詞中說明要修改的內容。不能傳 ratio、aspect_ratio 或 size，畫面比例沿用原影片；可以傳 resolution。
• 影片延長（1.1）：
  • 寫法為 task: "extend" 加 1 段 video，不能傳 duration、ratio 或 size。
  • 每次增加約 10 秒，resolution 可選 720p（預設）或 1080p，不支援 4K。
  • 輸入須為 1–30 秒的 MP4。較長的影片請先擷取結尾片段（建議 10 秒）再延長。
  • 依「成品時長 − 輸入時長」的新增秒數計費。可選擇傳入 input_duration（輸入影片秒數），與實測時長相差超過 0.1 秒時，請求會被拒絕。
• 延長結果是完整的 MP4，其中輸入部分由模型重新生成，與原片相似，但不是逐格複製。拼接時請保留原片的完整內容，只擷取延長結果中輸入時長之後的部分，接在原片後面。
• 可選 temperature（0–2）與 top_p（0–1）。Gemini Omni 不提供生成音訊開關。

首影格生成（Flash）：

{
  "model": "gemini-omni-flash",
  "prompt": "鏡頭緩緩推近，熱氣從糕點上冒起",
  "duration": 5,
  "ratio": "9:16",
  "image": "https://cdn.example.com/start.jpg"
}

參考圖加參考影片（1.1，4K）：

{
  "model": "gemini-omni-flash-1.1",
  "prompt": "保持參考影片的鏡頭節奏，將主體換成參考圖中的產品",
  "duration": 8,
  "resolution": "4k",
  "images": ["https://cdn.example.com/product.jpg"],
  "video": "https://cdn.example.com/reference.mp4"
}

影片延長（1.1）：

{
  "model": "gemini-omni-flash-1.1",
  "prompt": "延續目前的畫面，水面的漣漪自然擴散",
  "task": "extend",
  "resolution": "1080p",
  "video": "https://assets.88api.ai/media/task-videos/2026/10/example.mp4"
}