Kling v3
Génération vidéo Kling v3
- Mode de traitement asynchrone, renvoie un identifiant de tâche pour les requêtes ultérieures
- Prend en charge le text-to-video et l’image-to-video (contrôle de la première image / des première et dernière images)
- Prend en charge le mode standard (720P), le mode professionnel (1080P) et le mode 4K
- Prend en charge des durées de vidéo de 3 à 15 secondes
- Prend en charge la génération de vidéos avec audio
POST
Autorisation
string
requis
Tous les points de terminaison API nécessitent une authentification par Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :
Paramètres de la requête
string
requis
Nom du modèle de génération vidéoModèles pris en charge :
kling-v3— Kling v3 (recommandé)
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
true: vérifier les prompts et les images d’entrée avecomni-moderation-latestfalseou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Prompt textuelDécrivez en détail les scènes, actions et styles pour obtenir de meilleurs résultats. L’utilisation de prompts en anglais est recommandée.Exemple :
"a golden retriever running on the beach, sunset, cinematic"string
Prompt négatif pour exclure les contenus indésirablesExemple :
"blurry, low quality, distorted"string
défaut:"std"
Mode de générationOptions :
std— mode standard (720P)pro— mode professionnel (1080P)4k— mode 4K
stdinteger
défaut:"5"
Par défaut :
5
Durée de la vidéo (en secondes)Plage : 3 à 15 (minimum 3 secondes, maximum 15 secondes)⚠️ Note : doit être un nombre simple (par ex. 6), sans guillemets, sinon une erreur se produirastring
défaut:"16:9"
Format d’image de la vidéoOptions :
16:9— paysage9:16— portrait1:1— carré
16:9array<url>
Tableau d’URL d’images pour la génération image-to-video
- Fournir 1 image : utilisée comme première image
- Fournir 2 images : automatiquement assignées comme première image + dernière image
["https://example.com/first.jpg"]boolean
Ajouter ou non un filigrane
boolean
défaut:"false"
Générer ou non la vidéo avec audio
boolean
défaut:"false"
Activer ou non le mode multi-plans.
truefalse
string
Méthode de découpage des plans :
customize / intelligence.Obligatoire lorsque multi_shot=true.array<object>
Informations par plan, par exemple prompt et durée.Définissez l’ordre, le prompt et la durée des plans via Obligatoire lorsque
index, prompt et duration.- De 1 à 6 plans pris en charge
- Longueur maximale du contenu par plan : 512
- Chaque durée de plan doit être >= 1 et ne peut pas dépasser la durée totale de la tâche
- La somme des durées de tous les plans doit être égale à la
durationde premier niveau
multi_shot=true et shot_type=customize.array<object>
Liste des sujets de référence, jusqu’à 3 sujets.Notes :
- Créés à la volée via
name,description,element_input_urls
- Pour la création à la volée,
name,descriptionetelement_input_urlssont obligatoires element_input_urls: 2 à 4 images par sujet (la première comme image frontale, les autres comme références)- Référencez les éléments dans
promptavec@name, par ex."@element_dog chasing @element_cat on grass"
Contraintes des paramètres
mode=4kest pris en charge pourkling-v3image_urlsprend en charge jusqu’à 2 images (1 première image, 2 premières + dernière images)- L’entrée de la dernière image seule est invalide (la première image doit être incluse)
- Lorsque
multi_shot=true, lepromptde premier niveau peut être omis multi_promptprend en charge jusqu’à 6 plans, etindexdoit commencer à 1 et être continu
Matrice de prise en charge des fonctionnalités
Texte vers vidéo (Text-to-Video) vs Image vers vidéo (Image-to-Video)
Le système détermine automatiquement le mode selon queimage_urls est fourni ou non : aucune image signifie text-to-video, avec des images signifie image-to-video.
Réponse
integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse
Cas d’usage
Cas 1 : Texte vers vidéo (mode standard)
Cas 2 : Texte vers vidéo (mode Pro + prompt négatif)
Cas 3 : Texte vers vidéo (15 secondes)
Cas 4 : Image vers vidéo (première image)
Cas 5 : Image vers vidéo (contrôle première + dernière image)
Cas 6 : Générer une vidéo avec audio
Cas 7 : Storyboard multi-plans (customize, 15 secondes, portrait avec audio)
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un
task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats.