Passer au contenu principal
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.

Utilisez ce endpoint pour appliquer l’une des scènes d’effets prédéfinies de Kling et transformer les ressources d’entrée en une nouvelle courte vidéo.

​
Choisir une scène d’effet

  • hug et kiss sont deux préréglages d’interaction entre deux personnes
  • fuzzyfuzzy, squish, expansion et heart_gesture sont des effets prédéfinis stylisés
  • La forme exacte des ressources dépend de l’effet, mais la requête encapsule toujours les paramètres spécifiques au fournisseur dans input

​
Flux de tâche

1

Soumettre la requête d’effet

Envoyez effect_scene ainsi que l’objet input correspondant et stockez l’id de tâche renvoyé.
2

Interroger la tâche

Poursuivez avec Requêtes individuelles jusqu’à la fin de la tâche d’effet.
3

Conserver la ressource finale

Téléchargez ou dupliquez la vidéo d’effet terminée si vous avez besoin d’une conservation stable.
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
​
effect_scene
enum<string>
défaut:hug
requis

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

Options disponibles:
fuzzyfuzzy,
squish,
expansion,
hug,
kiss,
heart_gesture
​
input
object
requis

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

​
callback_url
string
défaut:https://example.com/webhook

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

​
external_task_id
string
défaut: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.

Réponse

200 - application/json

Task accepted.

​
code
integer
requis

Error code; specific error code definition

​
message
string
requis

Error message

​
data
object
requis