Introduction
Kling 2.1 Image to video est le seul mode que propose cette génération : envoyez une image de départ et un prompt décrivant ce qui se passe ensuite, choisissez une resolution en 720p (standard) ou 1080p (pro), et récupérez un clip silencieux de 5 ou 10 secondes. Une image de fin (last_image_url) n’est acceptée qu’en 1080p.
Choisissez une résolution selon votre budget
| Ce que vous voulez | Résolution |
|---|---|
| le palier le moins cher de cette gamme | 720p (standard) |
| un clip plus net, avec une image de fin optionnelle | 1080p (pro) |
Fonctionnalités et points forts
Un cadre de fin, mais seulement en 1080p
Réglez resolution sur 1080p et ajoutez un cadre de fin à côté de votre cadre de départ, et le clip est construit pour atterrir exactement sur cette pose au dernier cadre. En 720p, un cadre de fin n’est pas accepté : une requête qui en inclut un est refusée avant son exécution, sans frais — omettez-le à ce niveau et laissez le clip aller du cadre de départ jusqu’à là où le modèle décide de s’arrêter.
Aucune piste audio, sur aucun des deux niveaux
Ce modèle ne génère aucun son, ni en 720p ni en 1080p. C’est un fait simple à anticiper, pas un défaut — cela convient à des images destinées à un montage qui ajoutera plus tard sa propre voix, sa musique ou son design sonore.
Les cadres de début et de fin peuvent s’enchaîner proprement
Dans l’un de nos tests, une marche sur une jetée qui commençait dans la brume et se terminait sur une pose rapprochée face caméra a atterri presque exactement sur le cadre de fin fourni, avec un vent et un étalonnage des couleurs cohérents sur les cinq secondes entières.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez seulement ce qui se passe après l’image de départ : l’action et le mouvement de caméra. 1 caractères minimum · 5000 caractères maximum |
image_url | Oui | Image de départ. JPEG ou PNG uniquement. |
last_image_url | Non | Image de fin optionnelle, acceptée uniquement en 1080p. Une requête en 720p qui l’inclut est refusée, sans frais. |
resolution | Non | 720p (standard, le palier le moins cher) ou 1080p (pro, et le seul palier qui accepte une image de fin). |
duration_seconds | Non | Secondes entières, 5 ou 10. Détermine le prix. |
negative_prompt | Non | Une courte liste de ce que le clip doit éviter. 500 caractères maximum |
guidance_scale | Non | 0 à 1. Plus élevé colle davantage à votre formulation ; plus bas donne plus de liberté au modèle. |
Tarification
Facturé à la seconde du clip de sortie ; le palier pro 1080p coûte plus cher à la seconde que le palier standard 720p. Un téléversement que Kling refuse n’est pas facturé.
| Spécification | Prix |
|---|---|
| $0.035 / seconde |
| $0.068 / seconde |
Cas d’utilisation
Le test le moins cher d’une image de départ
Lancez d’abord le palier standard 720p pour voir si une action, un mouvement de caméra ou un cadrage fonctionne comme vous le voulez, avant de dépenser plus sur un palier supérieur ou une génération plus récente.
Une séquence à deux images avec une fin verrouillée
Utilisez le palier pro 1080p avec image_url et last_image_url quand la pose finale exacte compte — le dernier plan avant une coupe, par exemple.
Guide de prompt et conseils pratiques
Décrivez une action continue, du début à la fin
L’exemple de l’épée sur le toit ci-dessus nomme un seul arc, du mouvement à la posture de garde finale ; cette structure à un seul temps est plus fiable sur cette génération que plusieurs actions distinctes réunies dans un même prompt.
Ne comptez pas sur les détails longs et traînants pour garder leur forme
Cheveux longs, tissu qui traîne ou accessoires flottants sont le genre de détail que cette génération a tendance à perdre sur 10 secondes — une longue traîne en velours a visiblement raccourci à mi-parcours dans l’un de nos tests d’escalier. Gardez ces détails courts, ou prévoyez une retouche ensuite.
Adaptez la résolution à ce que demande le plan
Faites d’abord un essai en 720p tant que vous réglez encore l’action ou le mouvement de caméra, et réservez le niveau pro 1080p — avec son cadre de fin optionnel — à la prise que vous voulez garder.
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.1/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"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.
