Guide d'utilisation
Recettes de prompts pour le contrôle de mouvement Kling 3.0 : prompts à copier-coller et résultats réels
Le mouvement provient de la vidéo de référence, pas du prompt — voici les recettes concrètes, avec les charges utiles réelles de l'API et de vrais extraits de sortie.
La plupart des articles proposant des « recettes de prompts » pour les modèles vidéo supposent qu'il suffit de saisir une phrase et que le modèle invente le mouvement de lui-même. Ce n'est pas le cas du contrôle de mouvement de Kling 3.0 : si vous l'abordez avec cette attente, votre premier appel API renverra une erreur 400. Le modèle exige deux entrées obligatoires — une image de personnage et une vidéo de référence de mouvement de 3 à 30 secondes — et transfère sur votre personnage le mouvement et les expressions faciales de la vidéo de référence. Le champ texte prompt est facultatif : il ne fait qu'affiner le style, l'éclairage et la scène. Il ne décrit pas le mouvement.
La véritable « recette » n'est donc pas une phrase, mais une combinaison : quelle image de personnage + quel extrait de référence + comment utiliser le prompt facultatif. Voici deux recettes qui utilisent le même personnage et le même extrait de référence ; la seule variable est la présence ou non d'un prompt de style. Chaque extrait ci-dessous provient d'une vraie tâche kling-3.0/motion-control exécutée via l'API hiapi, et non d'une image simulée.
Ce dont le contrôle de mouvement Kling 3.0 a réellement besoin
| Champ | Obligatoire | Rôle |
|---|---|---|
image_url |
Oui | Le personnage qui exécute le mouvement |
video_url |
Oui | Extrait de 3 à 30 secondes fournissant le mouvement et les expressions faciales |
prompt |
Non | Contrôle uniquement le style, la scène et l'éclairage — pas le mouvement |
resolution |
Non | 720p ou 1080p |
La facturation se fait au nombre de secondes produites, avec un tarif par palier de résolution :
- 720p — 0,10 $/seconde
- 1080p — 0,172 $/seconde
Ainsi, un extrait de 6 secondes en 720p coûte 0,60 $ — c'est exactement le coût de chaque recette ci-dessous. Grille tarifaire complète : hiapi.ai/pricing.
Étape 1 — Obtenir l'image du personnage
Nous avons généré avec gpt-image-2 un portrait simple sous éclairage de studio (0,03 $/image, 1024×1024) :

N'importe quelle image de personnage nette et de face convient — illustration ou rendu photoréaliste. C'est le « qui ».
Étape 2 — Obtenir l'extrait de référence du mouvement
C'est l'étape que les gens sautent souvent, et c'est pourtant elle qui contrôle réellement la sortie. Si vous n'avez pas encore d'extrait montrant le mouvement souhaité, vous pouvez en générer un. Nous avons utilisé grok-imagine/text-to-video (0,015 $/seconde en 480p) pour générer un extrait de référence de 6 secondes à partir d'un prompt purement textuel :
{
"model": "grok-imagine/text-to-video",
"input": {
"prompt": "A person turns their head to look over their shoulder, raises one hand in a small wave, then smiles directly at the camera. Medium shot, static frame, soft daylight.",
"duration": "6",
"resolution": "480p"
}
}
Coût : 6 secondes × 0,015 $ = 0,09 $. Cet extrait est désormais réutilisable — vous pouvez l'appliquer à n'importe quelle image de personnage.
Recette A — Transfert de base, sans prompt de style
On fournit directement l'image du personnage et l'extrait de référence, sans aucun prompt :
{
"model": "kling-3.0/motion-control",
"input": {
"image_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/character-source.png",
"video_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/motion-reference.mp4",
"resolution": "720p"
}
}
Le personnage se retourne, salue de la main et sourit exactement aux mêmes instants que dans l'extrait de référence — l'éclairage et le cadrage correspondent au portrait source. Coût : 6 secondes × 0,10 $ (720p) = 0,60 $.
Recette B — Même mouvement, avec prompt de guidage stylistique
image_url et video_url sont strictement identiques. La seule différence est l'ajout d'un prompt décrivant une autre scène et un autre éclairage, tandis que le mouvement reste verrouillé sur l'extrait de référence :
{
"model": "kling-3.0/motion-control",
"input": {
"image_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/character-source.png",
"video_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/motion-reference.mp4",
"prompt": "Golden-hour outdoor lighting, warm rim light from the left, shallow depth of field with a softly blurred park background.",
"resolution": "720p"
}
}
Même séquence retournement-salut-sourire, aux mêmes instants — mais l'éclairage, l'étalonnage des couleurs et l'arrière-plan ont changé selon le prompt. Coût : 0,60 $ de plus.
Le vrai point clé
Si les recettes A et B vous font penser que « deux prompts différents ont produit deux vidéos différentes », c'est un modèle mental erroné. Le mouvement est identique dans les deux extraits, car la vidéo de référence est identique. Le prompt n'a modifié que le décor. Pour obtenir un mouvement différent — saluer au lieu de se retourner, marcher au lieu de saluer —, il faut changer la vidéo de référence, et non la formulation du prompt. Constituez une petite bibliothèque d'extraits de référence réutilisables (vos propres images, des contenus sous licence, ou générés comme à l'étape 2 ci-dessus) et réutilisez-les sur autant d'images de personnage que vous le souhaitez ; c'est le véritable levier pour passer à l'échelle vos sorties de contrôle de mouvement.
Pour un travail de texte-vers-vidéo où le prompt pilote réellement le mouvement, consultez notre recette de prompts pour Kling 3.0 Turbo, ou notre guide de grok-imagine texte-vers-vidéo, que nous avons utilisés pour produire l'extrait de référence ci-dessus.
Les deux modèles sont disponibles sur l'API hiapi, avec la même clé — aucune inscription distincte par modèle.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Guide de démarrage pour seedream-5.0-pro/image-to-image : capacités, tarification et points d'intégration
Limites de capacité, mode de facturation et pratiques d'intégration technique du modèle d'édition d'image de ByteDance
-
Guide d'utilisation
Guide de prise en main de la génération d'images par texte avec seedream-5.0-pro : limites de capacités, intégration API et maîtrise des coûts
Point de vue pratique pour les développeurs : des points clés des paramètres à l'estimation du coût de 0,05 $ par image
-
Guide d'utilisation
Guide de prise en main de Hailuo 2.3 Fast image-to-video : limites de capacités, tarification et intégration pratique
Points clés pour les développeurs : choisir et intégrer le modèle image-to-video de MiniMax