Ana içeriğe atla
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.

Bu endpoint’i kullanarak Kling’in hazır efekt sahnelerinden birini uygulayabilir ve giriş varlıklarını yeni bir kısa videoya dönüştürebilirsiniz.

Bir efekt sahnesi seçin

  • hug ve kiss, iki kişilik etkileşim preset’leridir
  • fuzzyfuzzy, squish, expansion ve heart_gesture, stilize hazır efektlerdir
  • Tam varlık biçimi efekte bağlıdır, ancak istek her zaman sağlayıcıya özgü ayarları input içinde kapsar

Görev akışı

1

Efekt isteğini gönderin

effect_scene ile eşleşen input nesnesini gönderin ve dönen görev kimliğini saklayın.
2

Görevi sorgulayın

Efekt işi tamamlanana kadar Individual Queries ile devam edin.
3

Nihai varlığı kalıcı olarak saklayın

Kararlı saklama gerekiyorsa tamamlanan efekt videosunu indirin veya yansıtın.
Tam parametre referansı için resmi Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json
effect_scene
enum<string>
varsayılan:hug
gerekli

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

Mevcut seçenekler:
fuzzyfuzzy,
squish,
expansion,
hug,
kiss,
heart_gesture
input
object
gerekli

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

callback_url
string
varsayılan:https://example.com/webhook

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

external_task_id
string
varsayılan: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.

Yanıt

200 - application/json

Task accepted.

code
integer
gerekli

Error code; specific error code definition

message
string
gerekli

Error message

data
object
gerekli