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-omni — Kling v3 Omni (interface unifiée)
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 positifPermet de référencer les images de image_urls via la syntaxe <<<image_N>>>, où N commence à 1.Exemple : "Make the person in <<<image_1>>> wave at the camera"
Si des images sont fournies mais que le prompt ne contient aucune référence <<<image_N>>>, le système ajoute automatiquement <<<image_1>>> au début du prompt.
string
Prompt négatif utilisé pour exclure les contenus indésirables. Longueur maximale : 2500 caractères.
string
défaut:"std"
Mode de générationOptions :
  • std — mode standard (720P)
  • pro — mode professionnel (1080P)
  • 4k — mode 4K Ultra HD
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 le référencement d’imagesRéférencez les images correspondantes dans le prompt via la syntaxe <<<image_N>>> (N commence à 1)Exemple : ["https://example.com/photo.jpg"]
  • 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
array<object>
Tableau d’images avec rôles, recommandé pour l’image-to-video.Format de chaque élément : { "url": "...", "role": "..." }
  • first_frame : première image
  • last_frame : dernière image
  • reference : image de référence
image_urls et image_with_roles sont mutuellement exclusifs. N’en utilisez qu’un seul.
array
Liste de vidéos de référence (basée sur URL), jusqu’à 1 vidéo.Utilisez refer_type pour distinguer les types :
  • base : vidéo à éditer (par défaut)
  • feature : vidéo de référence de caractéristiques
Utilisez keep_original_sound pour contrôler l’audio d’origine :
  • no : ne pas conserver (par défaut)
  • yes : conserver le son d’origine
Format de la requête :
  • video_url ne peut pas être vide, et l’URL de la vidéo doit être accessible
  • Lorsque refer_type=base :
    • Les images de début/fin ne peuvent pas être définies
    • La vidéo de référence doit durer 3 à 10 secondes
    • La durée de la vidéo générée suit celle de la vidéo téléversée
  • Lorsque refer_type=feature et que video_url n’est pas vide :
    • image_urls ne peut contenir qu’une image de première image
  • Exigences vidéo : MP4/MOV uniquement ; durée d’au moins 3 secondes ; résolution 720–2160 px ; fréquence d’images 24–60 fps (la sortie est de 24 fps) ; taille maximale 200 Mo
boolean
défaut:"false"
Activer ou non le mode multi-plans.
string
Méthode de découpage des plans : customize / intelligence.Obligatoire lorsque multi_shot=true.
array<object>
Liste multi-plans, chaque élément est { index, prompt, duration }.
  • Minimum 1 plan, maximum 6 plans
  • Chaque duration de plan doit être un entier >= 1
  • La somme des durées de tous les plans doit être égale à la duration de premier niveau
  • index doit commencer à 1 et augmenter de manière continue
  • Obligatoire lorsque multi_shot=true et shot_type=customize
Exemple :
array<object>
Liste des sujets de référence, jusqu’à 3 sujets. Prend en charge :
  • La création de sujets à la volée avec name, description, element_input_urls
Format général :
Notes :
  • Pour la création à la volée, name, description, 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)
  • Utilisez @name dans prompt, par ex. "@element_dog and @element_cat are playing on the grass"
boolean
Ajouter ou non un filigrane
boolean
défaut:"false"
Générer ou non la vidéo avec audio
Ce paramètre est mutuellement exclusif avec video_list.Lorsque video_list a une valeur, le paramètre audio n’est pas nécessaire.

Contraintes et limites des paramètres

  • image_urls et image_with_roles sont mutuellement exclusifs
  • mode=4k est disponible pour kling-v3-omni
  • L’entrée de la dernière image seule (last_frame sans première image) est invalide
  • Les images de début/fin et l’édition vidéo sont mutuellement exclusives : lorsque video_list.refer_type=base (ou omis), les images de début/fin ne sont pas autorisées
  • Lorsque video_list est présent, audio est ignoré
  • video_list prend en charge au maximum 1 vidéo
  • multi_prompt prend en charge jusqu’à 6 plans, avec index commençant à 1 et augmentant de manière continue

Syntaxe de référence d’image

Le modèle Omni utilise la syntaxe <<<image_N>>> pour référencer des images dans les prompts, offrant une expérience unifiée text-to-video / image-to-video :
Référence automatique : si image_urls est fourni mais que le prompt ne contient aucune référence <<<image_N>>>, le système ajoute automatiquement <<<image_1>>> au début du prompt.

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 : Référence d’image (image unique)

Cas 3 : Références à plusieurs images

Cas 4 : Image fournie sans référence explicite (ajoutée automatiquement)

Le système ajoute automatiquement <<<image_1>>> au début du prompt, ce qui équivaut à "<<<image_1>>>The person slowly turns and smiles".

Cas 5 : Générer une vidéo avec audio

Note : audio est mutuellement exclusif avec video_list. Lorsque video_list a une valeur, le paramètre audio n’est pas nécessaire.
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.