Skip to main content
POST

Authentification

string
requis
Toutes les interfaces nécessitent une authentification via Bearer TokenObtenir une clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APILors de l’utilisation, ajoutez dans l’en-tête de la requête :

Paramètres de requête

string
requis
Nom du modèle de génération de vidéoModèles pris en charge :
  • kling-3.0-turbo - Kling 3.0 Turbo
string
requis
Prompt textuelLa limite en amont est de 3072 caractères, il est recommandé de ne pas dépasser 2500 caractères.Exemple : "Un corgi court au bord de la mer, ambiance cinématographique, lumière du crépuscule"
string
Prend en charge une URL d’image ou une chaîne Base64.
Limites en amont pour la première image :
  • Format : .jpg / .jpeg / .png
  • Taille : ≤ 50MB
  • Largeur/hauteur : ≥ 300px
  • Rapport largeur/hauteur : 1:2.5 ~ 2.5:1
string
défaut:"16:9"
Rapport largeur/hauteur de la vidéoValeurs possibles :
  • 16:9 - Format horizontal
  • 9:16 - Format vertical
  • 1:1 - Format carré
Valeur par défaut : 16:9
Effectif uniquement pour la conversion texte-vidéo. Ce champ est inopérant pour la conversion image-vidéo, le rapport de la vidéo étant déterminé par la première image.
string
défaut:"720p"
Définition de la vidéoValeurs possibles :
  • 720p
  • 1080p
Valeur par défaut : 720p
integer
défaut:"5"
Durée de la vidéo (secondes)Plage de valeurs : 3-15 (minimum 3 secondes, maximum 15 secondes)Valeur par défaut : 5⚠️ Attention : vous devez saisir un nombre pur (par exemple 6), sans guillemets, sinon une erreur se produira
boolean
Ajouter ou non un filigraneN’est transmis en amont que s’il est explicitement fourni ; s’il n’est pas transmis, aucun filigrane n’est ajouté.

Texte-vidéo vs Image-vidéo

Le système détermine automatiquement le mode de génération selon que first_frame_image est fourni ou non : avec une première image, il s’agit de la conversion image-vidéo ; sans première image, il s’agit de la conversion texte-vidéo. L’utilisateur n’a pas besoin de le déclarer explicitement.

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données retourné

Cas d’usage

Cas 1 : Texte-vidéo (1080P)

Cas 2 : Texte-vidéo (format vertical 720P)

Cas 3 : Image-vidéo (première image)

Cas 4 : Image-vidéo pure à partir de la première image (sans prompt)

Cas 5 : Découpage multi-plans (texte-vidéo)

Interroger le résultat de la tâcheLa génération de vidéo est une tâche asynchrone ; après la soumission, un task_id est retourné. Utilisez l’interface Obtenir le statut de la tâche pour interroger la progression et le résultat de la génération.