Introduction
Kling 3.0 Motion Control prend une photo nette d’un personnage (image_url) et une vidéo pilote (video_url, 3 à 30 secondes) et rejoue les mouvements, expressions et gestes des mains de la vidéo pilote sur ce personnage, en gardant son visage, sa tenue et son décor tirés de la photo. La sortie dure exactement aussi longtemps que la vidéo pilote et est facturée sur cette durée, pas sur une durée que vous choisissez. prompt est optionnel — utilisez-le pour tout ce que la vidéo pilote ne montre pas, comme le décor ou le look.
Choisissez un mode Kling 3.0 selon votre matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène ou un script écrit | Kling 3.0 Texte vers vidéo |
| une image de départ, et en option une image de fin | Kling 3.0 Image vers vidéo |
| une photo de personnage et une vidéo pilote | Kling 3.0 Motion Control (vous êtes ici) |
Fonctionnalités et points forts
Une photo, une vidéo pilote, la même performance deux fois
Enregistrez ou licenciez une seule vidéo pilote — une danse, une marche, un geste — et appliquez-la à autant de photos de personnages que nécessaire. Dans notre test, la chorégraphie d’une même vidéo pilote est revenue calée temps pour temps sur deux personnages différents, chacun gardant son propre visage, ses vêtements et son fond.
Le résultat dure aussi longtemps que la vidéo pilote
Il n’y a pas de champ de durée à régler : la longueur de sortie correspond toujours à la vidéo pilote, de 3 à 30 secondes, et la facturation suit la même durée.
720p ou 1080p
Motion Control ne monte pas jusqu’en 4K. La résolution change le prix de la même façon que sur les autres endpoints Kling 3.0.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Non | Optionnel. Utilisez-le seulement pour ce que la vidéo pilote ne montre pas — le décor, le look, tout ce qu’il faut ajouter. 2500 caractères maximum |
negative_prompt | Non | Ce qui ne doit pas apparaître dans le clip (objets, rendus ou mouvements indésirables), jusqu’à 2 500 caractères. Facultatif ; sans effet sur le prix. 2500 caractères maximum |
image_url | Oui | Le personnage à animer : une photo nette, en pied ou en buste, de la personne. |
video_url | Oui | Vidéo pilote, 3 à 30 secondes : les mouvements, expressions et gestes à transférer. Le résultat dure aussi longtemps que ce clip et est facturé sur cette durée. |
resolution | Non | 720p ou 1080p. Le palier supérieur coûte plus cher à la seconde. |
keep_original_audio | Non | Conserve le son d’origine de la vidéo pilote dans le résultat. Actif par défaut. Valeur par défaut: |
character_orientation | Non | Orientation du personnage dans le résultat : video (par défaut) suit la personne de la vidéo pilote, image suit la personne de votre photo. |
shot_type | Non | Mode de découpage des plans : customize (par défaut) s’en tient à vos entrées, intelligent laisse le modèle planifier les plans lui-même. Sans effet sur le prix. |
Tarification
Facturé sur la durée de la vidéo pilote (video_url), arrondie à la seconde supérieure, de 3 à 30 secondes, pas sur une durée que vous fixez. La résolution change le tarif.
| Spécification | Prix |
|---|---|
| $0.1008 / seconde |
| $0.1344 / seconde |
Cas d’utilisation
Réutiliser une performance sur plusieurs personnages
Chorégraphiez ou licenciez une seule vidéo pilote, puis appliquez-la à chaque photo de personnage d’une série — une chorégraphie de danse, un ensemble de gestes d’un présentateur produit, un salut récurrent — sans retourner le mouvement à chaque fois.
Donner un vrai mouvement dirigé à une photo de personnage fixe
Plutôt que de décrire un mouvement en mots en espérant un geste précis, Motion Control vous permet de montrer le mouvement exact une seule fois, sous forme de vidéo pilote, et de l’appliquer avec précision.
Localiser une performance dans un nouveau décor
Utilisez le prompt optionnel pour placer le personnage dans un lieu différent de celui de la vidéo pilote, tandis que le mouvement lui-même reste identique.
Guide de prompt et conseils pratiques
Laissez la vidéo pilote porter le mouvement
Le prompt n’a pas besoin de décrire de mouvement — la vidéo pilote le fournit déjà. Utilisez-le seulement pour ce que le clip ne montre pas, comme la pièce, un détail de garde-robe ou l’ambiance.
Gardez la photo de personnage nette et centrée sur un seul sujet
Une photo nette, en pied ou en buste, d’une seule personne, bien éclairée et sans obstruction, donne à Motion Control la correspondance la plus nette. Une photo où le personnage est partiellement caché ou sous un angle inhabituel laisse davantage de place au modèle pour deviner.
Vérifiez que les deux entrées sont assez larges
La photo de personnage et la vidéo pilote ont toutes deux besoin d’environ 720 pixels ou plus sur chaque côté ; une vidéo pilote en dessous de ce seuil est rejetée avant même le début de la tâche, pas après que vous ayez payé pour elle.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.












