Skip to main content
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 avec omni-moderation-latest
  • false ou 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
Par défaut : std
integer
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 produira
string
défaut:"16:9"
Format d’image de la vidéoOptions :
  • 16:9 — paysage
  • 9:16 — portrait
  • 1:1 — carré
Par défaut : 16:9
array<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
2 images maximum prises en chargeExemple : ["https://example.com/first.jpg"]
  • 2 images maximum prises en charge
  • Les URL d’images doivent être publiquement accessibles, sans protection anti-hotlink
  • En mode image-to-video, aspect_ratio peut être remplacé par le rapport réel de l’image
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.
  • true
  • false
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 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 duration de premier niveau
Format :
Obligatoire lorsque multi_shot=true et shot_type=customize.
array<object>
Liste des sujets de référence, jusqu’à 3 sujets.
  • Créés à la volée via name, description, element_input_urls
Exemple :
Notes :
  • Pour la création à la volée, name, description et element_input_urls sont 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 prompt avec @name, par ex. "@element_dog chasing @element_cat on grass"

Contraintes des paramètres

  • mode=4k est pris en charge pour kling-v3
  • image_urls prend 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, le prompt de premier niveau peut être omis
  • multi_prompt prend en charge jusqu’à 6 plans, et index doit 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 que image_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.