Chuyển đến nội dung chính
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
  }
}
Sử dụng nhóm endpoint này sau khi bạn tạo một tác vụ Kling. Đây là bước polling phổ biến cho các job media async của Kling.

Những gì cần kiểm tra trước

  • Trạng thái tác vụ hoặc các trường tiến độ tác vụ do wrapper trả về
  • Metadata đầu ra hoặc URL asset khi tác vụ hoàn tất
  • Thông báo lỗi đặc thù của provider khi tác vụ dừng sớm

Mẫu polling

1

Tạo tác vụ từ endpoint tương ứng

Bắt đầu với trang tạo Kling cho workflow của bạn, chẳng hạn như Text to Video hoặc Image to Video.
2

Polling cho đến khi tác vụ ở trạng thái kết thúc

Tiếp tục truy vấn bằng task id đã trả về cho đến khi trạng thái đạt success hoặc failure.
3

Tiếp tục sang bước tiếp theo của workflow

Sử dụng trực tiếp đầu ra đã hoàn tất, hoặc chuyển sang trang thao tác đặc thù provider tiếp theo nếu workflow của bạn hỗ trợ các thao tác chuỗi.
Để xem tham chiếu tham số đầy đủ, hãy xem tài liệu Kling chính thức.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tham số đường dẫn

action
string
bắt buộc

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

action2
string
bắt buộc

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
bắt buộc

Task ID

Phản hồi

200 - application/json

Successful Response

code
integer
bắt buộc

Return code

message
string
bắt buộc

Text description of the request result

request_id
string
bắt buộc

Unique identifier for this request

data
object
bắt buộc

Object containing specific response data