Passer au contenu principal
POST
/
v3
/
async
/
kling-v3.0-motion-control
Contrôle des mouvements Kling V3.0
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
L’outil de contrôle des mouvements Kling V3.0 peut extraire une trajectoire de mouvement à partir d’une vidéo de référence et l’appliquer à une image de référence pour générer une vidéo, tout en préservant la cohérence du sujet. Il prend en charge les modes standard et professionnel, avec une facturation à la seconde.
Il s’agit d’une API asynchrone qui renvoie uniquement le task_id de la tâche asynchrone. Vous devez utiliser ce task_id pour appeler l’API de consultation du résultat de tâche afin de récupérer le résultat généré.

​
En-têtes de requête

​
Content-Type
string
requis
Valeur énumérée : application/json
​
Authorization
string
requis
Format d’authentification Bearer : Bearer {{API Key}}.

​
Corps de la requête

​
image
string
requis
URL de l’image de référence ou image encodée en base64 ; prend en charge .jpg, .jpeg, .png. La taille du fichier image ne doit pas dépasser 10 Mo ; la largeur et la hauteur doivent toutes deux être >= 300 px ; le rapport largeur/hauteur doit être compris entre 1:2.5 et 2.5:1.
​
video
string
requis
URL de la vidéo de mouvement de référence ; prend en charge .mp4, .mov. La taille du fichier vidéo ne doit pas dépasser 10 Mo ; la largeur et la hauteur doivent toutes deux être >= 300 px ; durée de 3 à 30 secondes.
​
prompt
string
Prompt positif décrivant la scène, le style, l’éclairage, etc. ; longueur maximale de 2500 caractères.Limite de longueur : 0 - 2500
​
model_name
string
défaut:"kling-v3-0-std"
requis
Nom du modèle. kling-v3-0-std : mode standard, excellent rapport coût-efficacité ; kling-v3-0-pro : mode professionnel, meilleure qualité vidéo.Valeurs possibles : kling-v3-0-std, kling-v3-0-pro
​
negative_prompt
string
Prompt négatif décrivant les éléments à éviter dans la vidéo générée ; longueur maximale de 2500 caractères.Limite de longueur : 0 - 2500
​
keep_original_sound
boolean
défaut:true
Indique s’il faut conserver l’audio original de la vidéo de référence.
​
character_orientation
string
requis
Mode de trame de sortie :
  • image : se base principalement sur la posture et la composition du personnage dans l’image de référence, et transfère le mouvement au personnage de l’image (sortie de 5 secondes)
  • video : se base principalement sur la posture et la composition du personnage dans la vidéo de référence, et applique le mouvement de la vidéo au personnage de l’image (durée de sortie identique à celle de la vidéo de référence, jusqu’à 30 secondes)
Valeurs possibles : image, video

​
Informations de réponse

​
task_id
string
requis
Utilisez task_id pour appeler l’API de consultation du résultat de tâche afin de récupérer la sortie générée.