查詢影片
查詢 Wan 3.0 平台影片物件的進度與結果。
使用建立API返回的公開任務 ID 查詢，回應為單個 video 物件。
讀取狀態與影片位址
status | 含義與處理 |
|---|---|
queued | 排隊中，稍後繼續查詢 |
in_progress | 處理中，稍後繼續查詢 |
completed | 生成完成，從 metadata.url 取得影片位址 |
failed | 生成失敗，讀取可用的 error 信息並停止輪詢 |
unknown | 未識別的任務狀態，不作為生成成功處理 |
儲存回應的 id；查詢物件不依賴建立回應中的冗余 task_id。不能僅根據 progress、completed_at 或 error 是否存在判斷成功；completed_at 來自平台記錄的更新時間，狀態以 status 為準。
成功後可直接儲存影片位址，或使用下載影片API。本API不返回原生 output/usage 物件；需要用量欄位時參閱原生查詢。
輪詢與錯誤處理
建議約每 15 秒查詢一次，並設定總等待超時。查詢讀取平台任務記錄，短時間重複查詢可能得到相同狀態；停止輪詢不會取消生成任務。
收到 HTTP 400 和 task_not_exist 時，請確認任務 ID 來自對應站點，並使用該任務所屬帳戶的 API Key。收到 HTTP 401 時，請先檢查鑒權，再繼續查詢。影片是否生成成功以 status 為準。