Chuyển đến nội dung chính
POST
/
kling
/
v1
/
videos
/
effects
Create a Kling video-effects task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/effects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effect_scene": "hug",
  "input": {
    "model_name": "kling-v1-6",
    "mode": "std",
    "images": [
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
    ],
    "duration": "10"
  }
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273960331935744",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366844624,
    "updated_at": 1773366844624
  }
}
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

  • hugkiss là hai preset tương tác giữa hai người
  • fuzzyfuzzy, squish, expansionheart_gesture là các hiệu ứng preset được phong cách hóa
  • Hình dạng tài nguyên chính xác phụ thuộc vào hiệu ứng, nhưng request luôn bọc các thiết lập riêng của nhà cung cấp bên trong input

Quy trình tác vụ

1

Gửi request hiệu ứng

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

Thăm dò task

Tiếp tục với Individual Queries 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 tất nếu bạn cần lưu giữ ổn định.
Xác thực trực tiếp vào ngày 2026-03-13 đã xác nhận rằng một request hug được chấp nhận mà không cần callback_url hoặc external_task_id và trả về task_status: submitted.
Để 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
enum<string>
mặc định:hug
bắt buộc

Preset effect to apply. Each effect defines a specific animation or interaction style.

Tùy chọn có sẵn:
fuzzyfuzzy,
squish,
expansion,
hug,
kiss,
heart_gesture
input
object
bắt buộc

Effect-specific input payload. Most interaction effects use one or more image URLs plus model settings.

callback_url
string
mặc định:https://example.com/webhook

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

external_task_id
string
mặc định:my-kling-effect-task-001

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