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
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

  • hug và kiss là hai preset tương tác giữa hai người
  • fuzzyfuzzy, squish, expansion, và heart_gesture là các hiệu ứng preset được cách điệu
  • Hình thức 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 dành riêng cho nhà cung cấp bên trong input

​
Luồng 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 task id được trả về.
2

Thăm dò task

Tiếp tục với Truy vấn riêng lẻ 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 trữ ổ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
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