Skip to main content
POST
cURL
Utilisez ce point de terminaison pour appliquer l’une des scènes d’effet prédéfinies de Kling et transformer les ressources d’entrée en une nouvelle courte vidéo.

Choisir une scène d’effet

  • Les effets à image unique utilisent effect_scene ainsi que input.image et input.duration
  • Les effets d’interaction entre deux personnes utilisent effect_scene ainsi que input.images avec exactement deux images
  • Les images d’entrée doivent respecter les exigences en pixels de Kling ; les minuscules vignettes sont rejetées par la tâche de génération
  • La forme exacte des ressources dépend de l’effet sélectionné, mais la requête encapsule toujours les paramètres d’effet dans input
  • Utilisez une scène d’effet actuellement disponible dans Kling ; CometAPI rejette les valeurs effect_scene inconnues
  • Évitez de vous appuyer sur une liste enum publique fixe ; la disponibilité des effets change selon la piste du modèle et la famille de scènes

Flux de tâche

1

Envoyer 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

Continuez avec Récupérer une tâche Kling jusqu’à ce que le traitement de l’effet soit terminé.
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
string
requis

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
requis

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

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

external_task_id
string

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