Skip to main content
POST
cURL
Sử dụng endpoint này để áp dụng một trong các cảnh hiệu ứng dựng sẵn của Kling và biến các tài nguyên đầu vào thành một video ngắn mới.

Chọn một cảnh hiệu ứng

  • Hiệu ứng một ảnh sử dụng effect_scene cùng với input.imageinput.duration
  • Hiệu ứng tương tác hai người sử dụng effect_scene cùng với input.images chứa đúng hai ảnh
  • Ảnh đầu vào phải đáp ứng yêu cầu pixel của Kling; hình thu nhỏ quá nhỏ sẽ bị tác vụ tạo từ chối
  • Hình dạng tài nguyên chính xác phụ thuộc vào hiệu ứng được chọn, nhưng yêu cầu luôn bao bọc các thiết lập hiệu ứng bên trong input
  • Sử dụng một cảnh hiệu ứng hiện có trong Kling; CometAPI sẽ từ chối các giá trị effect_scene không xác định
  • Tránh phụ thuộc vào một danh sách enum công khai cố định; khả năng dùng được của hiệu ứng thay đổi theo model track và nhóm cảnh

Luồng tác vụ

1

Gửi yêu cầu hiệu ứng

Gửi effect_scene cùng với đối tượng input tương ứng và lưu task id được trả về.
2

Thăm dò task

Tiếp tục với Lấy một task Kling cho đến khi job hiệu ứng hoàn tất.
3

Lưu trữ tài nguyên cuối cùng

Tải xuống hoặc sao chép video hiệu ứng đã hoàn thành nếu bạn cần lưu giữ ổn định.
Để xem tài liệu 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.

Nội dung

application/json
effect_scene
string
bắt buộc

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
bắt buộc

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Phản hồi

200 - application/json

Task accepted.

code
integer
bắt buộc

Error code; specific error code definition

message
string
bắt buộc

Error message

data
object
bắt buộc