AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
影片生成Wan

查詢任務 · 舊版格式

透過舊版回應格式查詢 Wan 3.0 影片任務。

此路徑返回 code/message/data 包裝的舊版任務物件。新接入優先使用平台查詢API;兩者的回應結構不能互換。

GET/v1/video/generations/{task_id}

授權

bearerAuth
授權Bearer <token>

使用平台 API Key:Authorization: Bearer your-api-key。

傳遞位置: header

路徑參數

task_id*string

平台返回的公開任務 ID,按字串儲存。查詢與下載均使用此值,不使用 request_id 或內層上游任務 ID。

長度1 <= length

回應主體

application/json

application/json

application/json

如何讀取舊版結果

code: "success" 只表示查詢成功,仍需檢查 data.status:

狀態含義
NOT_START/SUBMITTED/QUEUED尚未執行或已提交、排隊中
IN_PROGRESS處理中
SUCCESS成功,從 data.result_url 取得影片位址
FAILURE失敗,查看 data.fail_reason 並停止輪詢

data.progress 是字串,例如 "100%",不同於平台查詢的數值進度。created_at/updated_at/submit_time/start_time/finish_time 使用 Unix 秒時間戳記,尚未開始或完成時對應時間可為 0。回應範例展示任務相關欄位,實際回應可包含其他欄位。

查詢和下載均使用建立API返回的公開任務 ID,即本回應中的 data.task_id。data.data 是原生回應,其中的任務 ID 不用於平台查詢或下載。

輪詢與錯誤處理

建議約每 15 秒查詢一次,設定總等待超時,在終態停止輪詢。生成完成後及時儲存影片,停止查詢不會取消生成。

HTTP 400 的 task_not_exist 和 HTTP 401 屬於查詢請求錯誤,不是正常任務狀態;先檢查任務 ID、站點和 API Key,再處理返回的任務資料。

阿里雲萬相 3.0 影片生成官方文件查閱模型原生協議;本頁平台欄位與回應以頁面說明為準。