Veo 影片生成
透過 AceDataCloud 的 Google Veo API 生成 AI 影片。
設定: 請參閱驗證來設定 token。
快速開始
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
非同步: 請參閱非同步任務輪詢。透過
POST /veo/tasks並帶入{"id": "..."}進行輪詢。 這會立即回傳一個任務 ID。輪詢以取得結果:
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id from above>"}'
模型
| 模型 | 音訊 | 最佳用途 |
|---|---|---|
veo2 | 無 | 成本效益高的生成 |
veo2-fast | 無 | 快速且成本效益高的生成 (預設) |
veo3 | 有 (原生) | 完整影音生成 |
veo3-fast | 有 (原生) | 更快的影音生成 |
veo31 | 有 (原生) | Veo 3.1,最高品質 |
veo31-fast | 有 (原生) | Veo 3.1 快速變體 |
veo31-fast-ingredients | 有 (原生) | Veo 3.1 快速,圖片混合模式 |
工作流程
1. 文字轉影片
POST /veo/videos
{
"action": "text2video",
"prompt": "cinematic aerial shot of the Northern Lights over Iceland",
"model": "veo3",
"resolution": "1080p"
}
2. 圖片轉影片
將靜態圖片動畫化為影片。
POST /veo/videos
{
"action": "image2video",
"prompt": "the scene gently comes to life with wind and subtle motion",
"image_urls": ["https://example.com/landscape.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. 圖片混合轉影片 (多重圖片混合)
將 1–3 張參考圖片混合成影片 (僅 veo31-fast-ingredients)。
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://example.com/img1.jpg",
"https://example.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. 上採樣至 1080p
將先前生成的影片轉換為完整 1080p 解析度。
POST /veo/videos
{
"action": "get1080p",
"video_id": "your-video-id",
"model": "veo3"
}
參數
| 參數 | 值 | 說明 |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | 生成模式 |
model | 請參閱模型表格 | 要使用的模型 (預設: veo2-fast) |
resolution | "4k", "1080p", "gif" | 輸出解析度 (預設: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | 長寬比 — 僅適用於 image2video |
image_urls | 字串陣列 | 參考圖片 URL — 用於 image2video (最多 2 張) 或 ingredients2video (最多 3 張) |
video_id | 字串 | 要上採樣的影片 — 僅用於 get1080p |
translation | true / false | 自動將提示詞翻譯為英文 (預設: false) |
後製端點
生成影片後,可使用這些端點進行進一步處理:
放大 (POST /veo/upsample)
將生成的影片放大至 1080p、4K,或轉換為 GIF。
POST /veo/upsample
{
"video_id": "your-video-id",
"action": "4k"
}
| 參數 | 值 | 說明 |
|---|---|---|
video_id | 字串 | 來自 /veo/videos、/veo/extend、/veo/reshoot 或 /veo/objects 的任務 ID |
action | "1080p", "4k", "gif" | 放大目標 |
延伸 (POST /veo/extend)
延續現有影片 — AI 自動生成下一段落。
POST /veo/extend
{
"video_id": "your-video-id",
"model": "veo31-fast",
"prompt": "the camera slowly zooms out"
}
| 參數 | 值 | 說明 |
|---|---|---|
video_id | 字串 | 來自 /veo/videos 或先前 /veo/extend 的任務 ID |
model | "veo31-fast", "veo31" | 僅支援 Veo 3.1 系列 |
prompt | 字串 | 可選:引導延伸段落 |
重新拍攝 (POST /veo/reshoot)
重新渲染影片,保留相同內容但套用新的鏡頭運動。
POST /veo/reshoot
{
"video_id": "your-video-id",
"motion_type": "LEFT_TO_RIGHT"
}
| 參數 | 值 | 說明 |
|---|---|---|
video_id | 字串 | 來自 /veo/videos 的任務 ID (不能使用 /veo/extend 的輸出) |
motion_type | 請參閱下表 | 要套用的鏡頭運動 |
motion_type 值:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
物件 (POST /veo/objects)
使用遮罩修補在影片中插入或移除物件。
POST /veo/objects
{
"video_id": "your-video-id",
"action": "insert",
"prompt": "add a flying bird"
}
POST /veo/objects
{
"video_id": "your-video-id",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| 參數 | 值 | 說明 |
|---|---|---|
video_id | 字串 | 任務 ID (不能使用 /veo/extend 的輸出) |
action | "insert", "remove" | 操作類型 |
prompt | 字串 | insert 時必填;remove 時可選 |
image_mask | 字串 | URL 或 base64 JPEG — 白色像素代表目標區域。remove 時必填;insert 時可選 |
注意事項
- Veo 3 和 3.1 模型會生成原生音訊 —
veo2/veo2-fast不支援音訊 get1080p動作使用video_id(來自先前生成的結果),而不是 URLaspect_ratio僅適用於image2video動作image_urls接受陣列 —image2video最多 2 張圖片,ingredients2video最多 3 張veo31-fast-ingredients必須輸入圖片 — 無法進行純文字生成translation: true會自動將中文或其他非英文提示詞翻譯成英文後再發送給 Veo- 任務輪詢使用
id(而非task_id) 作為/veo/tasks請求體中的鍵值 - 任務狀態使用
"succeeded"(而非 "completed") — 輪詢時請檢查此值 /veo/extend的輸出不能作為/veo/reshoot或/veo/objects的輸入
MCP:
pip install mcp-veo| 託管版:https://veo.mcp.acedata.cloud/mcp| 請參閱所有 MCP 伺服器