API vidéo Kling

Cette page décrit l’appel du modèle vidéo Kling de Kuaishou, kling-3.0-turbo. Comme les autres modèles vidéo, il se crée avec POST /v1/videos et s’interroge avec GET /v1/videos/{id} ; l’authentification, le téléversement des médias, les états d’interrogation, le téléchargement des résultats et la gestion des erreurs sont décrits dans la spécification complète de l’API vidéo. Cette page ne présente que les champs et règles propres à Kling.

Mis à jour le 2026-10-10. Les modèles Kling prennent en charge uniquement l’interrogation : ne définissez pas callback_url lors de la création, sinon la requête est rejetée.

Modèles

resolution sélectionne le niveau de sortie, qui détermine aussi la facturation, sans tenir compte de la casse (4k équivaut à 4K) ; à défaut, le niveau le plus bas 720p s’applique. Un niveau non pris en charge renvoie 400, sans repli automatique vers un niveau inférieur.

Règles communes

• Durée : nombre entier de secondes de 4 à 15 dans duration (ou seconds sous forme de chaîne) ; 5 secondes par défaut.
• Format d’image : ratio (ou aspect_ratio) accepte 16:9, 9:16 et 1:1.
• Prompt : prompt est obligatoire, 2000 caractères maximum.
• Génération audio : generate_audio (booléen) est pris en charge.
• Audio de référence : non pris en charge ; envoyer un audio de référence renvoie 400.
• Champs facultatifs : negative_prompt (prompt négatif) et seed (entier).

Images et vidéos de référence

Placez les images de référence dans images au niveau racine et les vidéos de référence dans metadata.referenceVideos. Jusqu’à 30 images (images de début et de fin comprises) et 10 vidéos.

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "Garder l’apparence du produit des images et le rythme de caméra de la vidéo de référence, le produit tourne lentement sur une table",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

Images de début et de fin

Placez l’image de début et l’image de fin dans metadata.firstFrame et metadata.lastFrame. lastFrame doit être accompagné de firstFrame. Kling permet d’envoyer les images de début et de fin avec des images de référence, dans la limite de 30 images au total.

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "La caméra glisse de la côte à l’aube vers la même baie au crépuscule",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Téléversement de fichier

Vous pouvez aussi envoyer directement un fichier image local avec multipart/form-data, dans le champ input_reference ; dans ce cas, n’envoyez pas images ni image dans la même requête. Les vidéos de référence ne peuvent pas être envoyées sous forme de fichier : obtenez d’abord une URL comme indiqué dans Téléverser un média local.

Anciens noms de modèles

Les anciens noms de modèles avec suffixe de niveau, kling-3.0-turbo-720p, kling-3.0-turbo-1080p, kling-3.0-turbo-2k et kling-3.0-turbo-4k, ont été retirés le 2026-10-10 : une requête qui les utilise renvoie une erreur. Utilisez kling-3.0-turbo et choisissez le niveau avec resolution.