Langsung ke konten utama
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.

Gunakan endpoint ini untuk menerapkan salah satu scene efek preset dari Kling dan mengubah aset input menjadi video pendek baru.

​
Pilih scene efek

  • hug dan kiss adalah preset interaksi dua orang
  • fuzzyfuzzy, squish, expansion, dan heart_gesture adalah efek preset bergaya
  • Bentuk aset yang tepat bergantung pada efeknya, tetapi request selalu membungkus pengaturan khusus penyedia di dalam input

​
Alur tugas

1

Kirim request efek

Kirim effect_scene beserta objek input yang sesuai dan simpan id task yang dikembalikan.
2

Poll task

Lanjutkan dengan Individual Queries hingga job efek selesai.
3

Simpan aset akhir

Unduh atau mirror video efek yang sudah selesai jika Anda memerlukan retensi yang stabil.
Untuk referensi parameter lengkap, lihat dokumentasi resmi Kling.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
effect_scene
enum<string>
default:hug
wajib

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

Opsi yang tersedia:
fuzzyfuzzy,
squish,
expansion,
hug,
kiss,
heart_gesture
​
input
object
wajib

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

​
callback_url
string
default:https://example.com/webhook

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

​
external_task_id
string
default: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.

Respons

200 - application/json

Task accepted.

​
code
integer
wajib

Error code; specific error code definition

​
message
string
wajib

Error message

​
data
object
wajib