跳轉到主要內容
GET
/
kling
/
v1
/
{action}
/
{action2}
/
{task_id}
Individual queries
curl --request GET \
  --url https://api.cometapi.com/kling/v1/{action}/{action2}/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "parent_video": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    },
    "created_at": 123,
    "updated_at": 123
  }
}
在你建立 Kling 任務之後,使用這組端點。這是 Kling 非同步媒體工作常見的輪詢步驟。

先檢查哪些項目

  • 包裝器回傳的任務狀態或任務進度欄位
  • 任務完成時的輸出中繼資料或資產 URL
  • 任務提前停止時,供應商特定的失敗訊息

輪詢模式

1

從對應的端點建立任務

先從適合你工作流程的 Kling 建立頁面開始,例如 文字轉影片圖片轉影片
2

輪詢直到任務進入終態

持續使用回傳的 task id 查詢,直到狀態變成 success 或 failure。
3

繼續進行工作流程的下一步

直接使用完成的輸出,或如果你的工作流程支援鏈式操作,前往下一個供應商特定操作頁面。
完整參數參考請見 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

Successful Response

code
integer
必填

Return code

message
string
必填

Text description of the request result

request_id
string
必填

Unique identifier for this request

data
object
必填

Object containing specific response data