本文介紹了如何對接 Veo Videos Generation API，通過輸入自定義參數生成Veo官方視頻。

下面將詳細闡述 Veo Videos Generation API 的對接流程。

申請流程

使用 API 前，需前往?Veo Videos Generation API?頁面申請服務。進入頁面后，點擊「Acquire」按鈕，如下圖所示：

如果尚未登錄或注冊，將自動跳轉至登錄頁面，邀請您注冊或登錄。登錄后將返回到當前頁面。

首次申請時會獲得免費額度，可免費使用該 API。

基本使用

基本使用方式為輸入提示詞?prompt、生成行為?action、首尾幀參考圖片數組?image_urls?及模型?model?來獲取處理結果。需首先傳遞?action?字段，值為?text2video，此字段包含三種行為：文生視頻（text2video）、圖生視頻（image2video）、獲取1080p視頻（get_1080p）。接著需輸入模型?model，當前可選擇?veo2、veo2-fast、veo3?和?veo3-fast，具體內容如下：

可以看到設置了請求頭部，包括：

• accept：希望收到的響應格式，此處填寫為?application/json，即 JSON 格式。
• authorization：調用 API 需要的密鑰，申請后可以直接下拉選擇。

同時設置了請求主體，包括：

• model：生成視頻時使用的模型，主要有?veo2、veo2-fast、veo3?和?veo3-fast。
• action：視頻生成任務的行為，包括文生視頻（text2video）、圖生視頻（image2video）、獲取1080p視頻（get_1080p）。
• image_urls：若選擇圖生視頻行為?image2video，必須上傳的首尾幀參考圖片鏈接。
• prompt：提示詞。
• callback_url：需要回調結果的 URL。

選擇后，會自動生成對應的代碼，如圖所示：

點擊「Try」按鈕可進行測試，得到如下結果：

json { "success": true, "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11", "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269", "data": [ { "id": "253eedc47f1c4eb2a370ed2312168f4b", "video_url": "https://platform.cdn.acedata.cloud/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4", "created_at": "2025-07-25 16:07:43", "complete_at": "2025-07-25 16:10:28", "state": "succeeded" } ] }

返回的結果包括多個字段，具體如下：

• success：當前視頻生成任務狀態。
• task_id：當前視頻生成任務的 ID。
• data：視頻生成任務結果。
• id：視頻生成任務的視頻 ID。
• video_url：視頻生成任務的視頻鏈接。
• created_at：視頻生成任務創建時間。
• complete_at：視頻生成任務完成時間。
• state：視頻生成任務狀態。

收到滿意的視頻信息后，可以根據?data?中視頻鏈接獲取生成的Veo視頻。

如果想生成對應的對接代碼，可以直接復制，例如 CURL 的代碼如下：

shell curl -X POST 'https://api.acedata.cloud/veo/videos' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "text2video", "model": "veo2", "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle." }'

圖生視頻功能

如果想根據首尾幀圖片生成視頻，需將參數?action?設置為?image2video，同時輸入首尾幀圖片鏈接數組?image_urls。

接下來必須填寫提示詞以自定義生成視頻，可指定如下內容：

• model：生成視頻的模型，主要有?veo2、veo2-fast、veo3?和?veo3-fast。
• image_urls：必須上傳的首尾幀參考圖片鏈接。
• prompt：提示詞。

填寫示例如下：

填寫完成后自動生成的代碼如下：

對應的 Python 代碼為：

```python import requests

url = "https://api.acedata.cloud/veo/videos"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "action": "image2video", "model": "veo2", "prompt": "Let it dance", "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"] }

response = requests.post(url, json=payload, headers=headers) print(response.text) ```

點擊運行，可以得到如下結果：

json { "success": true, "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87", "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8", "data": [ { "id": "59f12222b1fa4fbe9331ff2400ad1583", "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4", "created_at": "2025-07-25 16:13:07", "complete_at": "2025-07-25 16:16:12", "state": "succeeded" } ] }

結果與前文一致，從而實現圖生視頻功能。

獲取1080p視頻功能

如需對已生成的視頻獲取1080p，可將參數?action?設置為?get_1080p，并輸入需要獲取1080p的視頻 ID，視頻 ID 可通過基本使用獲取，如圖所示：

此時視頻的 ID 為：

json "id": "59f12222b1fa4fbe9331ff2400ad1583"

注意，此處的?video_id?是生成后視頻的 ID，若不知如何生成視頻，請參考前文基本使用生成視頻。

接下來需填寫提示詞以自定義生成視頻，可指定如下內容：

• model：生成視頻的模型，主要有?veo2、veo2-fast、veo3?和?veo3-fast。
• video_id：參考的視頻 ID，用于獲取1080p視頻。

填寫示例如下：

填寫完成后自動生成的代碼如下：

點擊運行后將得到如下結果：

json { "success": true, "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984", "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d", "data": [ { "id": "59f12222b1fa4fbe9331ff2400ad1583", "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4", "created_at": "2025-07-25 16:13:07", "complete_at": "2025-07-25 16:16:12", "state": "succeeded" } ] }

結果與前文一致，從而實現獲取1080p視頻功能。

指定視頻尺寸生成

如需生成自定義尺寸的Veo視頻，可將參數?aspect_ratio?設置為所需尺寸，接下來需填寫提示詞以自定義生成視頻，可指定如下內容：

• model：生成視頻的模型，主要有?veo2、veo2-fast、veo3?和?veo3-fast。
• aspect_ratio：視頻尺寸，支持?16:9、3:4、4:3、1:1，默認值為?16:9。
• translation：是否啟用提示詞自動翻譯，默認值為?false。

填寫示例如下：

填寫完成后將自動生成代碼如下：

點擊運行后將得到如下結果：

json { "success": true, "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687", "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886", "data": [ { "id": "fc667e7d3b8f44beaa61a3c339af0e50", "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4", "created_at": "2025-08-24 20:09:06", "complete_at": "2025-08-24 20:10:45", "state": "succeeded" } ] }

結果與前文一致，從而實現指定尺寸生成視頻的功能。

異步回調

鑒于 Veo Videos Generation API 的生成時間較長，通常需要 1-2 分鐘。如果 API 長時間沒有響應，HTTP 請求將保持連接，導致系統資源消耗增加，因此本 API 提供了異步回調支持。

整體流程為：客戶端發起請求時，額外指定?callback_url?字段。API 請求后將立即返回結果，包含一個?task_id?字段，代表當前任務 ID。當任務完成后，生成的視頻結果將以 POST JSON 形式發送至客戶端指定的?callback_url，同時也包含?task_id?字段，便于通過 ID 關聯任務結果。

以下是具體操作的示例。

首先，Webhook 回調為可接收 HTTP 請求的服務，開發者應替換為自己搭建的 HTTP 服務器的 URL。此處為方便演示，使用一個公開的 Webhook 示例網站 https://webhook.site/，打開該網站即可獲得 Webhook URL，如下圖所示：

將此 URL 復制，作為 Webhook 使用，例如?https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc。

接下來，設置字段?callback_url?為上述 Webhook URL，并填寫相應參數，具體內容如圖所示：

點擊運行，將立即得到如下結果：

json { "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed" }

稍等片刻，在?https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc?可以觀察生成視頻結果，如圖所示：

內容如下：

json { "success": true, "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed", "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56", "data": [ { "id": "2f43ceed37944b4d836e1a1899dad0a1", "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4", "created_at": "2025-07-25 17:19:20", "complete_at": "2025-07-25 17:21:45", "state": "succeeded" } ] }

結果中帶有一個?task_id?字段，其他字段與前文類似，通過此字段可實現任務關聯。

錯誤處理

調用 API 時遇到錯誤，API 將返回相應的錯誤代碼與信息，如：

• 400 token_mismatched：錯誤請求，可能因缺失或無效參數造成。
• 400 api_not_implemented：錯誤請求，可能因缺失或無效參數造成。
• 401 invalid_token：未經授權，無效或缺失授權令牌。
• 429 too_many_requests：請求過多，超出速率限制。
• 500 api_error：內部服務器錯誤，服務器出現問題。

錯誤響應示例

json { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" }

結論

通過本文檔，您已了解如何使用 Veo Videos Generation API，通過輸入提示詞及首幀參考圖片生成視頻。希望本文檔能夠幫助您更好地對接與使用該 API。如有任何疑問，請隨時聯系我們的技術支持團隊。