Efek Video

Gunakan API Kling Video Effects melalui CometAPI untuk menerapkan efek bergaya pada video dengan POST /kling/v1/videos/effects dan mengontrol parameter efek.

POST /kling/v1/videos/effects

Create a Kling video-effects task

cURL

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

200

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273960331935744",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366844624,
    "updated_at": 1773366844624
  }
}

Gunakan endpoint ini untuk menerapkan salah satu scene efek preset milik 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 provider di dalam input

​

Alur tugas

1. Kirim request efek

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

2. Poll task

   Lanjutkan dengan Individual Queries sampai job efek selesai.

3. Simpan aset akhir

   Unduh atau mirror video efek yang sudah selesai jika Anda memerlukan retensi yang stabil.

Validasi langsung pada 2026-03-13 mengonfirmasi bahwa request hug diterima tanpa callback_url atau external_task_id dan mengembalikan task_status: submitted.

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.

Show child attributes

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

Show child attributes