Introduction
Kling 2.1 Master Image to video anime une image de départ en un clip de 5 ou 10 secondes en 1080p, sans piste audio et sans option d’image de fin sur cet endpoint — seulement image_url.
Choisissez un mode Kling 2.1 Master selon votre matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène écrite | Kling 2.1 Master Texte vers vidéo |
| une image de départ validée | Kling 2.1 Master Image vers vidéo |
Fonctionnalités et points forts
Le cadre reste fixe, le prompt fournit le mouvement
La garde-robe, la pose, la lumière et le décor du cadre de départ restent exactement tels qu’envoyés ; le prompt n’a qu’à décrire ce qui se passe ensuite et où va la caméra. Dans nos tests, une vague océanique figée et une robe de bal sous l’eau ont toutes deux pris vie de façon convaincante à partir d’une seule image fixe, cadrage et costume intacts.
Pas de cadre de fin sur cet endpoint
Contrairement à l’image-to-video standard de Kling 2.1, celle de Master n’accepte que image_url, pas de last_image_url. Si une pose finale précise compte, décrivez-la directement dans le prompt et laissez le modèle y travailler, plutôt que d’attendre qu’une seconde image fixe la fin.
Les cadres verticaux peuvent faire paraître le visage plus petit
Quand le cadre de départ est un recadrage vertical, le rendu suit ce format, et dans l’un de nos tests le visage est ressorti plus petit et légèrement moins détaillé qu’avec un cadre horizontal. Un recadrage facial plus serré sur un cadre de départ vertical apporte plus de détail dans le clip final.
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. |
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 — utile pour écarter les défauts de rendu courants sur des mouvements de caméra complexes. 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
$0.216 / seconde
Facturé à la seconde du clip de sortie. Un téléversement que Kling refuse n’est pas facturé.
Cas d’utilisation
Porter une image fixe précise à son meilleur niveau de mouvement
Utilisez ce niveau quand le cadre de départ est déjà exactement le bon — lumière, garde-robe, pose — et que le rendu doit être la version définitive, pas un brouillon à comparer à des prises moins chères.
Mouvement atmosphérique : tissu, eau, feu, poussière
Robes flottantes, vagues qui se soulèvent, brume à la dérive et lustre qui se balance ont tous été rendus de façon naturelle dans nos tests à partir d’une image fixe et d’un prompt décrivant le mouvement, ce qui convient à tout plan construit autour de l’atmosphère plutôt que du dialogue ou de l’action rapide.
Un second clip haute fidélité dans le même projet
Comme cet endpoint partage le tarif plus élevé de Master avec son équivalent texte-vers-vidéo, traitez-le de la même façon : réservez-le à un plan déjà validé ailleurs, et réglez d’abord le texte sur un niveau moins cher.
Guide de prompt et conseils pratiques
Dites aux éléments du cadre fixe quand bouger
Indiquez ce qui est déjà dans le cadre — une vague, une pose, une tenue — et décrivez l’ordre dans lequel cela doit prendre vie, plutôt que de redécrire toute la scène depuis le début ; le modèle sait déjà à quoi ressemble l’image.
Associez negative_prompt à une caméra en orbite ou à la dérive
Un negative_prompt court, nommant par exemple des visages flous ou des mains déformées, est un moyen simple d’écarter une orbite lente ou une dérive façon sous-marine des artefacts de rendu les plus courants de ce modèle, surtout une fois le clip à ses 10 secondes complètes.
Recadrez le visage un peu plus serré sur les cadres verticaux
Si le cadre de départ est un recadrage vertical, cadrez le visage plus près que vous ne le feriez pour un plan horizontal ; un recadrage vertical large peut faire paraître le visage petit une fois le clip en mouvement, comme dans l’un de nos tests sur cadre vertical.
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-master/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"
}
}'
# 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.
