Introduction
Kling 2.6 Motion Control transfère les mouvements, expressions et gestes d’une vidéo pilote sur un personnage à partir d’une photo fixe. Donnez-lui une photo nette de la personne et un clip de 3 à 30 secondes montrant la performance, et il renvoie une vidéo silencieuse en 720p ou 1080p qui dure exactement aussi longtemps que la vidéo pilote.
Choisissez un mode Kling 2.6 selon votre matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène écrite | Kling 2.6 Texte vers vidéo |
| une image de départ validée | Kling 2.6 Image vers vidéo |
| une vidéo pilote et une photo de personnage | Kling 2.6 Motion Control |
Fonctionnalités et points forts
La propre photo du personnage l’emporte sur tout ce que la vidéo pilote ne dicte pas
Dans notre test, une chorégraphie hip-hop exécutée par une danseuse a été transférée sur un autre homme en costume trois pièces bleu marine : les mouvements correspondaient pas à pas, et son costume, ses mocassins, son visage et le loft en béton de sa propre photo se sont tous poursuivis, plutôt que le fond de studio neutre de la vidéo pilote.
Sortie silencieuse, durée fixée par la vidéo pilote
Il n’y a pas de champ audio sur cet endpoint — le résultat est rendu silencieux — ni de champ de durée non plus, puisque la sortie correspond toujours à la durée de la vidéo pilote, de 3 à 30 secondes.
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 déjà — le décor à garder, un détail de garde-robe, tout ce que vous voulez maintenir constant. 2500 caractères maximum |
image_url | Oui | Le personnage à animer : une seule photo nette, en pied ou en buste, de la personne. JPEG ou PNG uniquement. |
video_url | Oui | Vidéo pilote, 3 à 30 secondes : les mouvements, expressions et gestes à transférer. Le résultat dure exactement aussi longtemps que ce clip et n’a pas d’audio. |
resolution | Non | 720p ou 1080p. Les paliers supérieurs coûtent plus cher à la seconde. |
Tarification
Facturé à la seconde de la durée de la vidéo pilote — la sortie dure exactement aussi longtemps que votre vidéo d’entrée.
| Spécification | Prix |
|---|---|
| $0.069 / seconde |
| $0.112 / seconde |
Cas d’utilisation
Réutiliser une performance sur plusieurs personnages
Filmez ou générez une seule vidéo pilote une fois, puis appliquez-la à différentes photos de personnages pour recaster la même chorégraphie, marche ou geste sans la ranimer depuis zéro à chaque fois.
Donner un mouvement réel à une image de personnage fixe
Donnez vie à un personnage déjà conçu ou généré avec une performance existante, quand le mouvement doit paraître délibéré plutôt qu’improvisé.
Guide de prompt et conseils pratiques
Dites ce qu’il faut garder, pas ce qu’il faut copier
La vidéo pilote porte déjà les mouvements, expressions et gestes — le champ prompt sert à tout ce qu’elle ne peut pas montrer, le plus souvent quel décor garder : la propre pièce du personnage, plutôt que celle de la vidéo pilote.
Faites correspondre le cadrage de la vidéo pilote et de la photo
Notre test associait une vidéo pilote en pied à une photo de personnage en pied. Un décalage de cadrage important entre les deux — une photo en buste pilotée par un clip en pied, par exemple — est le genre d’entrée à tester d’abord en basse résolution.
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 de chaque côté ; une vidéo pilote en dessous de ce seuil est rejetée avant que le job ne démarre, pas après que vous l’avez payé. Vérifiez les deux dimensions de la vidéo pilote, car une vidéo peut passer en largeur et quand même échouer en hauteur si elle a été tournée dans un cadrage inhabituel.
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/2.6/character-animation",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
