Lấy một tác vụ Kling

GET

kling

{action}

{action2}

{task_id}

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

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

Sử dụng nhóm endpoint này sau khi bạn tạo một tác vụ Kling. Đây là bước thăm dò phổ biến cho các tác vụ đa phương tiện bất đồng bộ của Kling.

Một truy vấn có thể trả về trực tiếp đối tượng tác vụ hoặc bên trong data envelope tiêu chuẩn. Chuẩn hóa từng phản hồi bằng task = payload.data ?? payload trước khi đọc các trường của tác vụ.

Những điều cần kiểm tra trước tiên

task.task_status; các tác vụ Motion Control sử dụng submitted, processing, succeed, hoặc failed
task.task_result.videos[0].url khi một tác vụ video thành công
task.task_status_msg hoặc các trường chi tiết khác được trả về khi tác vụ dừng sớm
code, message, và request_id khi phản hồi sử dụng envelope tiêu chuẩn envelope

Mẫu thăm dò

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

Bắt đầu từ trang tạo Kling dành cho quy trình của bạn, chẳng hạn như Văn bản sang video, Hình ảnh sang video, hoặc Motion Control.

Thăm dò cho đến khi tác vụ kết thúc

Chuẩn hóa cấu trúc phản hồi, rồi tiếp tục truy vấn bằng ID tác vụ được trả về cho đến khi tác vụ đạt trạng thái kết thúc. Với Motion Control, các trạng thái kết thúc là succeed và failed.

Tiếp tục đến bước quy trình tiếp theo

Sử dụng trực tiếp đầu ra đã hoàn tất, hoặc chuyển sang trang hành động phù hợp tiếp theo nếu quy trình của bạn hỗ trợ các thao tác liên kết.

Các cặp đường dẫn phổ biến

Quy trình	Đường dẫn truy vấn
Văn bản sang video	`/kling/v1/videos/text2video/{task_id}`
Hình ảnh sang video	`/kling/v1/videos/image2video/{task_id}`
Motion Control	`/kling/v1/videos/motion-control/{task_id}`
Video nhiều hình ảnh	`/kling/v1/videos/multi-image2video/{task_id}`
Hiệu ứng video	`/kling/v1/videos/effects/{task_id}`
Mở rộng video	`/kling/v1/videos/video-extend/{task_id}`
Video avatar	`/kling/v1/videos/avatar/image2video/{task_id}`

Để xem tài liệu tham khảo đầy đủ về tham số, 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, motion-control, 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

Current Kling task state.

Option 1
Option 2

A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.

task_id

string

bắt buộc

Kling task ID.

task_status

string

bắt buộc

Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.

task_status_msg

string

Failure or status detail when returned.

task_info

object

Additional task metadata. The object can be empty.

task_result

object

Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.

Show child attributes

watermark_info

object

Watermark information when returned by a compatible workflow.

Show child attributes

created_at

integer<int64>

Task creation timestamp in milliseconds.

updated_at

integer<int64>

Last task update timestamp in milliseconds.

final_unit_deduction

string

Final unit deduction value, when returned.

final_balance_deduction

object

Final balance deduction values, when returned.

Show child attributes

Lần sửa đổi cuối 31 tháng 7, 2026

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

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

Kiểm duyệt nội dung

Khóa API

Những điều cần kiểm tra trước tiên

Mẫu thăm dò

Các cặp đường dẫn phổ biến

Ủy quyền

Tham số đường dẫn

Phản hồi

​Những điều cần kiểm tra trước tiên

​Mẫu thăm dò

​Các cặp đường dẫn phổ biến

Ủy quyền

Tham số đường dẫn

Phản hồi

Những điều cần kiểm tra trước tiên

Mẫu thăm dò

Các cặp đường dẫn phổ biến