Introduction
Le mode référence vers vidéo de Kling 4.0 Flash produit une nouvelle scène 720p à partir d’un prompt obligatoire et de références fournies. Ajoutez jusqu’à 10 images et 5 clips vidéo pour une durée vidéo cumulée de 20 secondes. Désignez les images par @Image1 et les vidéos par @Video1, en poursuivant la numérotation selon l’ordre d’import.
Expliquez dans le prompt l’apport de chaque référence. Dans l’exemple du désert, une image identifie le sujet et deux vidéos guident le mouvement de caméra dans une scène au crépuscule. Les nouveaux clips durent 3–20 secondes entières, avec 5 secondes par défaut, et comportent un son synchronisé ; keep_original_audio permet de conserver le son d’une vidéo de référence. Les fichiers audio de référence ne sont pas acceptés.
Fonctionnalités et points forts
- Associez jusqu’à 10 images de référence aux sujets, objets ou détails de scène dans le prompt.
- Orientez le mouvement et le cadrage avec 5 vidéos maximum, cumulant au plus 20 secondes.
- Reliez la description de la scène aux fichiers fournis grâce aux identifiants @Image1 et @Video1.
- Générez un résultat 720p de 3–20 secondes avec son, ou conservez le son d’une vidéo de référence grâce à
keep_original_audio. - Reprenez le cadrage des entrées avec auto, ou optez pour 16:9, 9:16, 1:1 ou 21:9.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Consignes de scène obligatoires, sans texte prédéfini ; attribuez un rôle à @Image1, @Image2, @Video1 et aux imports suivants. La formulation du prompt ne coûte rien de plus. 1 caractères minimum |
reference_image_urls | Non | Fournissez jusqu’à 10 URL d’images, à nommer @Image1, @Image2, etc., dans l’ordre d’import. Elles orientent la scène sans modifier le tarif. 1 éléments minimum · 10 éléments maximum |
reference_video_urls | Non | Fournissez jusqu’à 5 URL de vidéos cumulant 20 secondes, à nommer @Video1, @Video2, etc. 1 éléments minimum · 5 éléments maximum |
aspect_ratio | Non | Choisissez auto pour suivre les références, ou définissez 16:9, 9:16, 1:1 ou 21:9. Le cadrage ne change pas le tarif par seconde et n’ajoute aucuns frais. |
keep_original_audio | Non | Réglez sur true pour garder le son de la vidéo de référence, ou sur false pour générer une nouvelle bande sonore ; ce réglage s’applique lorsqu’une vidéo de référence est fournie. Valeur par défaut: |
duration_seconds | Non | La durée de sortie accepte un entier de 3 à 20 secondes, avec 5 secondes par défaut. Elle détermine le total facturé au travers de la durée de sortie. |
Tarification
$0.113 / seconde
La génération avec références est facturée à la seconde de sortie. L’ajout d’une vidéo de référence applique un tarif par seconde plus élevé à la durée de sortie ; la durée des vidéos de référence n’est pas facturée séparément. Les images, la formulation du prompt, le format d’image et keep_original_audio n’occasionnent aucun supplément. Les requêtes refusées par la modération de Kling sont sans frais.
Cas d’utilisation
- Placez le sujet d’une image dans une scène sociale au désert, guidée par de courts clips de mouvement.
- Explorez l’association d’un personnage et d’un lieu avec des images de référence nommées séparément.
- Construisez plusieurs brouillons courts autour d’un mouvement de caméra choisi pour évaluer les contenus.
Guide de prompt et conseils pratiques
- Précisez la fonction de chaque image, comme « @Image1 définit le sujet », avant de décrire la nouvelle scène.
- Expliquez ce qu’il faut reprendre d’une vidéo, comme « utilisez l’approche lente de la caméra de @Video1 », pour donner un objectif précis à la référence.
- Décrivez le nouveau décor, par exemple « un désert calme au crépuscule », pour distinguer la scène demandée des références.
- Demandez une action concise, comme « le voyageur s’arrête près du panneau », pour un brouillon de 3 secondes.
- Si vous générez une nouvelle bande sonore, ajoutez une indication comme « Son : vent sec et train lointain » pour orienter l’audio inclus.
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-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"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.
