Introduction
Kling 4.0 Référence vers vidéo crée un nouveau clip à partir de ce que vous importez : jusqu’à 10 images de référence pour les personnes, les objets et les lieux, jusqu’à 5 vidéos de référence (30 secondes au total) pour le mouvement, la caméra et le rythme, et jusqu’à 3 clips audio pour une voix ou un son. Nommez chacun dans le prompt en @Image1, @Image2, @Video1 ou @Audio1, numérotés dans l’ordre d’import. Les clips durent de 3 à 30 secondes en 720p ou 1080p, avec une bande sonore stéréo.
Choisir un mode selon le matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène écrite ou un scénario | Kling 4.0 Texte vers vidéo |
| une première image, et éventuellement une dernière image et des images intermédiaires | Kling 4.0 Image vers vidéo |
| des photos, des clips ou des échantillons de voix à distribuer | Kling 4.0 Référence vers vidéo (vous êtes ici) |
Fonctionnalités et points forts
Images, vidéos et voix dans une même requête
Kling 4.0 accepte les trois types de référence ensemble. Les images définissent qui et quoi apparaît, les vidéos définissent comment la caméra et le sujet bougent, et les clips audio définissent la façon dont quelqu’un parle.
Nommer chaque référence dans le prompt
Écrivez @Image1, @Image2 et ainsi de suite dans l’ordre d’import, et dites ce que chacune représente. Dans notre exemple de caravane, « @Image1 est la femme, @Image2 est la caravane chromée » a suffi pour placer cette femme devant cette caravane.
Emprunter un mouvement de caméra à un clip
Une vidéo de référence transmet son mouvement et son rythme. Activez keep_original_audio pour conserver le son propre de ce clip au lieu de générer une nouvelle bande sonore. Les secondes de la vidéo de référence sont aussi facturées, à un tarif inférieur à celui des secondes de sortie.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Dites ce que représente chaque référence et ce que le plan en fait. 1 caractères minimum |
reference_image_urls | Non | Jusqu’à 10 images de personnes, d’objets, de tenues ou de lieux, désignées par @Image1, @Image2 et ainsi de suite. Elles ne modifient pas le prix. 1 éléments minimum · 10 éléments maximum |
reference_video_urls | Non | Jusqu’à 5 vidéos, 30 secondes au total, pour le mouvement, la caméra et le rythme, désignées par @Video1, @Video2. 1 éléments minimum · 5 éléments maximum |
reference_audio_urls | Non | Jusqu’à 3 clips audio de 5 à 30 secondes chacun pour une voix ou un son, désignés par @Audio1, @Audio2. Écrivez les paroles prononcées dans le prompt. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | auto (par défaut) suit les images ou la vidéo de référence ; 16:9, 9:16, 1:1 ou 21:9 le fixent vous-même. Ne modifie pas le prix. |
resolution | Non | 720p ou 1080p (par défaut 720p). Le 1080p coûte plus cher à la seconde. |
keep_original_audio | Non | Désactivé par défaut. Valeur par défaut: |
duration_seconds | Non | Secondes entières, de 3 à 30 (par défaut 5). Détermine le prix. |
Tarification
Facturé à la seconde de sortie, plus les secondes de toute vidéo de référence (chaque clip arrondi à la seconde entière) à un tarif inférieur. Le 1080p coûte plus cher à la seconde que le 720p. Les images de référence et les clips audio ne modifient pas le prix. Une requête refusée ou en échec n’est pas facturée.
| Spécification | Prix |
|---|---|
| $0.216 / seconde |
| $0.324 / seconde |
Cas d’utilisation
Placer une personne dans un lieu où elle n’a jamais été photographiée
Un portrait plus une photo d’un lieu donne une scène de cette personne là-bas, avec l’action que vous décrivez.
Garder un accessoire ou un véhicule cohérent
Donnez à une voiture, une moto ou une tenue sa propre image de référence pour qu’elle reste identique d’un clip à l’autre.
Faire correspondre une voix
Ajoutez un échantillon vocal de 5 à 30 secondes en @Audio1 et écrivez la réplique entre guillemets ; la réplique suit cette voix.
Guide de prompt et conseils pratiques
Commencez par la liste des acteurs
Commencez par une phrase par référence — « @Image1 est l’homme, @Image2 est la moto » — puis décrivez le plan.
Quelques références nettes valent mieux que beaucoup de semblables
Une photo nette par personne ou par objet donne de meilleurs résultats que plusieurs quasi-doublons que le modèle doit moyenner.
Laissez aspect_ratio sur auto
En auto, le clip suit la forme de vos références ; ne le réglez que si vous avez besoin d’un cadre précis.
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/4.0/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.










