愛詩-圖生視頻模型根據 輸入圖像 和 文本提示詞 ,生成一段流暢的視頻。
重要本文件僅適用於新加坡地域,且必須使用該地域的API Key。
服務開通
- 前往阿里雲百鍊控制台,搜尋 PixVerse,找到 PixVerse 模型卡片,單擊立即開通;
- 在彈窗內確認開通及授權。
適用範圍
為確保呼叫成功,請務必保證模型、endpoint URL 和 API Key 均屬於同一地域。跨地域呼叫將會失敗。
- 選擇模型:確認模型所屬的地域。
- 選擇 URL:選擇對應的地域 Endpoint URL,支援HTTP URL或 DashScope SDK URL。
- 設定 API Key:取得該地域的API Key,再設定API Key到環境變數。
說明本文的示例程式碼適用於新加坡地域。
HTTP呼叫
圖生視頻任務耗時較長(通常為1-5分鐘),API採用非同步呼叫的方式。整個流程包含 "建立任務 -> 輪詢取得" 兩個核心步驟,具體如下:
步驟1:建立任務取得任務ID
新加坡地域:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
呼叫時請將{WorkspaceId}替換為真實的業務空間ID。
說明
- 建立成功後,使用介面返回的
task_id查詢結果,task_id 有效期為 24 小時。請勿重複建立任務,輪詢取得即可。 - 新手指引請參見Postman。
請求參數請求頭(Headers)Content-Type 請求內容類型。此參數必須設定為 Authorization 請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。示例值:Bearer sk-xxxx。 X-DashScope-Async 非同步處理設定參數。HTTP請求只支援非同步,必須設定為 重要缺少此請求頭將報錯:“current user api does not support synchronous calls”。 請求體(Request Body)model 模型名稱。 可選值:
input 輸入的基本資訊,如提示詞、媒體素材等。 parameters 視頻處理參數,如設定視頻解析度、設定視頻時長、開啟音訊生成、添加水印等。 | 圖生視頻支援模型:pixverse/pixverse-v6-it2v。 Python SDK圖生視頻(多鏡頭)支援模型:pixverse/pixverse-v6-it2v。 在 |
響應參數output 任務輸出資訊。 request_id 請求唯一標識。可用於請求明細溯源和問題排查。 code 請求失敗的錯誤碼。請求成功時不會返回此參數,詳情請參見錯誤碼。 message 請求失敗的詳細資訊。請求成功時不會返回此參數,詳情請參見錯誤碼。 | 成功響應請儲存 task_id,用於查詢任務狀態與結果。 異常響應建立任務失敗,請參見錯誤碼進行解決。 |
步驟2:根據任務ID查詢結果
新加坡地域:GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
請求參數請求頭(Headers)Authorization 請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。示例值:Bearer sk-xxxx。 URL路徑參數(Path parameters)task_id 任務ID。 | 查詢任務結果將 |
響應參數output 任務輸出資訊。 usage 輸出資訊統計,只對成功的結果計數。 request_id 請求唯一標識。可用於請求明細溯源和問題排查。 | 任務執行成功任務執行失敗若任務執行失敗,task_status將置為 FAILED,並提供錯誤碼和資訊。請參見錯誤碼進行解決。 任務查詢過期task_id查詢有效期為 24 小時,超時後將無法查詢,返回以下報錯資訊。 |
錯誤碼
如果模型呼叫失敗並返回報錯資訊,請參見錯誤碼進行解決。