查詢任務 · 舊版格式
透過舊版回應格式查詢 Wan 3.0 影片任務。
此路徑返回 code/message/data 包裝的舊版任務物件。新接入優先使用平台查詢API;兩者的回應結構不能互換。
如何讀取舊版結果
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,再處理返回的任務資料。