取得 Kling 任務

GET

kling

{action}

{action2}

{task_id}

TASK_ID="<task_id>"

curl "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "<task_id>",
  "data": {
    "task_id": "<task_id>",
    "task_status": "processing",
    "task_info": {},
    "task_result": {},
    "created_at": 1781080355827,
    "updated_at": 1781080362336
  }
}

在建立 Kling 任務之後，請使用這組端點。這是 Kling 非同步媒體工作常見的輪詢步驟。

先檢查哪些項目

查詢確認用的 code、message 與 request_id
任務狀態的 data.task_status，例如 submitted、processing、succeed 或 failed
任務成功時的 data.task_result.videos[0].url
任務提早停止時的 data.task_status_msg 或其他回傳的詳細欄位

輪詢模式

從對應的端點建立任務

先從符合你工作流程的 Kling 建立頁面開始，例如文字轉影片或圖片轉影片。

輪詢直到任務進入最終狀態

持續使用回傳的 task id 進行查詢，直到 data.task_status 變成 succeed 或 failed。

繼續下一個工作流程步驟

直接使用完成的輸出，或是如果你的工作流程支援串接操作，前往下一個供應商專屬的操作頁面。

常見路徑配對

工作流程	查詢路徑
文字轉影片	`/kling/v1/videos/text2video/{task_id}`
圖片轉影片	`/kling/v1/videos/image2video/{task_id}`
多圖片影片	`/kling/v1/videos/multi-image2video/{task_id}`
影片特效	`/kling/v1/videos/effects/{task_id}`
影片延長	`/kling/v1/videos/video-extend/{task_id}`
虛擬人像影片	`/kling/v1/videos/avatar/image2video/{task_id}`

完整參數參考請見官方 Kling 文件。

授權

Authorization

string

header

必填

Bearer token authentication. Use your CometAPI key.

路徑參數

action

string

必填

Resource type. One of: images, videos, audio.

action2

string

必填

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id

string

必填

Task ID

回應

200 - application/json

Current Kling task state.

code

integer

必填

Kling response code. 0 indicates the query was accepted.

message

string

必填

Kling response message.

request_id

string

必填

Identifier for this query request.

data

object

必填

Show child attributes

使用 Kling 辨識圖片

建立 Kling Omni 影片

TASK_ID="<task_id>"

curl "https://api.cometapi.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "<task_id>",
  "data": {
    "task_id": "<task_id>",
    "task_status": "processing",
    "task_info": {},
    "task_result": {},
    "created_at": 1781080355827,
    "updated_at": 1781080362336
  }
}

內容審核

API 金鑰

先檢查哪些項目

輪詢模式

常見路徑配對

授權

路徑參數

回應

​先檢查哪些項目

​輪詢模式

​常見路徑配對

授權

路徑參數

回應

先檢查哪些項目

輪詢模式

常見路徑配對