跳轉到主要內容
GET
/
kling
/
v1
/
videos
/
omni-video
/
{task_id}
Omni Query
curl --request GET \
  --url https://api.cometapi.com/kling/v1/videos/omni-video/{task_id} \
  --header 'Authorization: Bearer <token>'
{}
在你建立 Kling Omni 任務後,請使用此端點。它會回傳包裝層任務狀態、巢狀的提供商 payload,以及任務成功時的最終影片 URL。

先檢查這些欄位

  • 外層 codemessage,用於判斷包裝層狀態
  • data.statusdata.progress,用於判斷非同步作業狀態
  • data.data.task_result.videos[0].url,用於取得完成後的 MP4 URL

輪詢模式

1

先建立任務

先從 Omni Video 開始,並儲存回傳的 task_id
2

輪詢直到任務進入終態

持續查詢,直到外層狀態變為 SUCCESSFAILURE
3

使用回傳的 MP4 URL

任務成功後,請儘快下載或複製最終影片 URL。
於 2026-03-12 的即時驗證回傳了 action: OMNI_VIDEO、外層 status: SUCCESS、巢狀 task_status: succeed,以及最終 MP4 URL。

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

路徑參數

task_id
string
必填

Task id returned by the Omni Video endpoint.

回應

200 - application/json

成功

The response is of type object.