查詢影片
讀取 Wan 3.0 原生任務狀態、影片位址和用量。
使用建立回應的 output.task_id 查詢，返回的 output.task_id 仍是平台公開任務 ID。結果和用量分別位於 output 與 usage。
狀態與結果
output.task_status | 含義與處理 |
|---|---|
PENDING | 排隊中 |
RUNNING | 處理中 |
SUCCEEDED | 成功，從 output.video_url 讀取結果 |
FAILED | 失敗，讀取 output.code/message 並停止輪詢 |
CANCELED | 已取消，停止輪詢 |
UNKNOWN | 任務狀態未知，不作為成功處理 |
建議約每 15 秒查詢一次，並設定總等待超時。查詢讀取平台儲存的任務記錄，狀態由後台更新；不要使用重複建立代替查詢。
影片生成成功後請及時下載儲存，避免結果位址失效。
用量與時間欄位
usage.duration 為總用量時長；有輸入影片時，包含輸入與輸出影片時長。input_video_duration/output_video_duration 可含小數，不應按請求時長的整數規則解析。其他可返回欄位包括 video_count、fps、SR 和 ratio。
submit_time/scheduled_time/end_time 是 UTC+8 時間字串，存在時返回，不是 Unix 時間戳記。request_id 用於追蹤請求，不用於查詢任務。
查詢錯誤
收到 HTTP 400 和 task_not_exist 時，請檢查公開任務 ID、呼叫站點和 API Key 所屬帳戶；這與任務的 UNKNOWN 狀態不同。收到 HTTP 401 時，請檢查 Bearer 鑒權。
錯誤回應可能僅包含頂層 code/message/request_id，不包含 output。如需使用 video 物件格式，參閱平台查詢API。