Skip to main content
POST

Autorisation

string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-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-v2-6 — Kling v2.6 (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 textuel, maximum 2500 caractèresDécrivez les scènes, actions et styles en détail pour de meilleurs résultats de générationExemple : "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
string
défaut:"std"
Mode de générationOptions :
  • std — mode standard (720P, vidéo silencieuse uniquement)
  • pro — mode professionnel (1080P, prend en charge la génération audio automatique)
Par défaut : std
Limitation du mode standard : le mode std ne prend en charge que les vidéos silencieuses. Le paramètre audio nécessite le mode pro.
integer
défaut:"5"
Durée de la vidéo (secondes)Options : 5 ou 10Par défaut : 5
string
défaut:"16:9"
Rapport d’aspect de la vidéoOptions :
  • 16:9 — paysage
  • 9:16 — portrait
  • 1:1 — carré
Par défaut : 16:9
string
Prompt négatif pour exclure le contenu indésirableExemple : "blurry, low quality, distorted"
array<url>
Tableau d’URLs d’images pour la génération image-to-video
  • Transmettre 1 image : utilisée comme première trame
  • Transmettre 2 images : assignées automatiquement comme première trame + dernière trame (nécessite mode: "pro")
Maximum 2 images prises en chargeExemple : ["https://example.com/first.jpg"]
  • Maximum 2 images prises en charge
  • La dernière trame (2 images) nécessite uniquement le mode pro ; le mode std ne prend en charge que la première trame (1 image)
  • La dernière trame et l’audio sont mutuellement exclusifs : en mode pro, la dernière trame (2 images) et l’audio (audio: true) ne peuvent pas être utilisés ensemble
  • En mode image-to-video, aspect_ratio peut être remplacé par le rapport d’aspect réel de l’image
boolean
défaut:"false"
Générer automatiquement un audioPar défaut : false
  • Disponible uniquement en mode: "pro"
  • Mutuellement exclusif avec la dernière trame : l’audio ne peut pas être utilisé avec la dernière trame (2 images)
boolean
Ajouter un filigrane

Matrice de prise en charge des fonctionnalités

Remarque : en mode pro, le contrôle de la dernière trame et de l’audio sont mutuellement exclusifs et ne peuvent pas être utilisés ensemble.

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 : sans images signifie text-to-video, avec 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’utilisation

Cas 1 : Texte vers vidéo (mode standard)

Cas 2 : Texte vers vidéo (mode Pro + prompt négatif)

Cas 3 : Image vers vidéo (première trame)

Cas 4 : Image vers vidéo (contrôle première + dernière trame)

Cas 5 : Mode Pro + audio automatique

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 l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.