查詢影片
查詢 Kling 4.0 原生文生、圖生和 Omni 任務的狀態與結果。
使用建立回應中的 data.id 查詢任務，成功後從 outputs 讀取影片網址並儘快儲存。平台只回傳目前使用者可存取的任務資料。
GET
/kling/tasks/{task_id}查詢目前使用者的單個 Kling 4.0 任務，適用於文生、圖生和 Omni 生成。 使用系統回傳的任務 ID，不是 options.external_task_id。 任務狀態為 submitted、processing、succeeded 或 failed。停止輪詢不等於取消任務。 billing 僅公開目前任務的刊例價與幣種，不包含帳戶帳單或內部扣費明細。
billing.list_price 是對應幣種的刊例價，不是平台最終扣費金額。價格可能晚於影片結果出現，未回傳價格不代表免費。
狀態與結果儲存
查詢回應中的 data 是任務數組，即使透過單個任務 ID 查詢，也應按數組讀取。查詢請求的 code 與生成任務的 status 含義不同，需要檢查任務狀態後再使用結果。
status | 含義 |
|---|---|
submitted | 已提交，等待處理 |
processing | 處理中，可稍後繼續查詢 |
succeeded | 生成成功，從 outputs 讀取影片結果 |
failed | 生成失敗，檢視任務的 message 了解原因並停止輪詢 |
影片結果的 type 為 video，id 為影片 ID，duration 是以字串回傳的秒數。url 為影片防盜鏈網址；需要帶水印結果時，檢視實際回傳的 watermark_url。
上游生成結果將在 30 天後清理，請儘快下載儲存。這是結果清理規則，不代表防盜鏈 URL 保證持續有效 30 天。
查詢錯誤與任務失敗
| 情況 | 檢查與處理 |
|---|---|
HTTP 400，task_not_exist | 使用建立時回傳的系統任務 ID，檢查 API Key 和所屬站點；不要使用 options.external_task_id |
HTTP 401，Invalid token | 檢查 Bearer 驗證格式及 Key 是否有效；缺少 Key 和無效 Key 可能回傳相同錯誤 |
HTTP 200，任務 status: "failed" | 查詢本身成功，但生成失敗；讀取此任務的 message，停止輪詢 |
HTTP 錯誤的回應包裝不一定與成功的 data[] 一致。不要把 HTTP 400/401 當作任務的 failed 狀態，也不要在驗證錯誤或任務不存在時持續輪詢。