Skip to main content
POST

Authentification

string
requis
Toutes les requêtes 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 l’en-tête suivant à chaque requête :

Paramètres de la requête

string
requis
Nom du modèle : kling-v3-motion-control ou kling-v2-6-motion-control
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
Prompt textuel décrivant le mouvement, les mouvements de caméra et le style souhaitésFacultatif mais recommandé — des descriptions plus précises produisent des résultats plus stablesExemple : "The character dances following the reference video, smooth motion, realistic style"
string
requis
URL de l’image de référenceDoit être un lien publiquement accessible
string
requis
URL de la vidéo de référenceDoit être un lien direct publiquement accessible ; mp4/mov recommandé, taille inférieure à 100 Mo
Le serveur détecte la durée réelle de video_url. La durée minimale est de 3 secondes ; la durée maximale dépend de character_orientation.
string
défaut:"yes"
Conserver ou non la piste audio originale de la vidéo de référenceOptions :
  • yes : conserver l’audio d’origine (par défaut)
  • no : ne pas conserver l’audio d’origine
string
requis
Contrôle de l’orientation du personnageOptions :
  • image : utiliser l’orientation du personnage de l’image de référence (durée de la vidéo de référence : 3~10s)
  • video : utiliser l’orientation du personnage de la vidéo de référence (durée de la vidéo de référence : 3~30s)
string
requis
Mode de générationOptions :
  • std : mode standard (équilibre vitesse / qualité)
  • pro : mode haute qualité (latence plus élevée)
object
Objet de contrôle du filigrane (optionnel)

Règles de durée

La durée facturée correspond à la durée réelle détectée par le serveur depuis video_url, et non à une estimation côté client.

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

Exemples

Exemple 1 : orientation par image (dans la limite de 10 s)

Exemple 2 : orientation par vidéo (dans la limite de 30 s)