Introduction
Kling O3 Reference to video compose un plan à partir de jusqu’à 7 photos de référence — personnages, tenues, objets ou lieux — au lieu d’une seule image de départ. Numérotez les références dans le prompt (image 1, image 2, et ainsi de suite) et dites ce que chacune apporte ; le champ prompt accepte jusqu’à 2 500 caractères. Choisissez une durée de 3 à 15 secondes entières, une résolution jusqu’en 4K, un format d’image, et si le son natif doit être généré.
Choisissez un mode Kling O3 selon votre matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène écrite et rien d’autre | Kling O3 Texte vers vidéo |
| une image de départ validée | Kling O3 Image vers vidéo |
| jusqu’à 7 photos de référence | Kling O3 Référence vers vidéo |
| une vidéo que vous avez déjà | Kling O3 Modifier une vidéo |
Fonctionnalités et points forts
Plusieurs références, un seul plan
Contrairement à image-to-video, qui part d’une seule image, reference-to-video prend jusqu’à 7 photos séparées et combine ce que chacune montre. Notre exemple de wagon-restaurant en utilisait trois : un homme, une pièce et un objet, réunis dans une scène qu’aucune des trois photos ne représentait seule.
Chaque référence a un rôle précis
Le prompt est l’endroit où vous attribuez ce rôle : « l’image 1 est l’homme, gardez son manteau et sa barbe naissante » est ce qui préserve ce visage et cette garde-robe intacts, au lieu que le modèle les moyenne avec les autres références.
Son généré avec la scène composée
generate_audio ajoute ambiance, effets et dialogues dans la même passe. Restez réaliste pour un bruit d’ambiance décrit en une phrase ou deux — il peut ressortir discrètement dans le mixage final plutôt que comme une couche dominante.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Dites ce qu’est chaque référence numérotée (<<< |
reference_image_urls | Oui | Jusqu’à 7 photos de référence pour des personnages, objets, tenues ou lieux. JPEG ou PNG. 1 éléments minimum · 7 éléments maximum |
reference_video_urls | Non | Vidéo de référence facultative, un seul clip, dont le nouveau plan reprend le mouvement, la caméra ou les personnages ; désignez-la dans le prompt comme <<< |
elements | Non | Un sujet nommé pour les rendus 4K : donnez-lui un nom, une description d’une ligne et 2 à 4 photos de la même personne ou du même objet (des échantillons de voix de 5 à 30 secon… 1 éléments maximum |
aspect_ratio | Non | 16:9, 9:16 ou 1:1. Choisissez-le avant d’écrire le plan pour que la composition s’adapte. |
resolution | Non | 720p, 1080p ou 4K. Les paliers supérieurs coûtent plus cher à la seconde. |
generate_audio | Non | Ajoute une bande sonore générée dans la même passe — dialogues entre guillemets, effets, ambiance. Valeur par défaut: |
keep_original_audio | Non | Conserve le son d’origine de la vidéo de référence dans le résultat. Actif par défaut ; ne compte que si vous fournissez une vidéo de référence. Valeur par défaut: |
duration_seconds | Non | Secondes entières, de 3 à 15. Détermine le prix avec la résolution et l’audio. |
shot_type | Non | single demande un plan continu (sans garantie absolue). multi laisse le modèle découper la scène en plusieurs plans tout seul. |
multi_prompt | Non | La liste de plans pour |
Tarification
Facturé à la seconde de sortie. Le tarif dépend de la résolution, de l’activation de l’audio natif et de la présence d’une vidéo de référence.
| Spécification | Prix |
|---|---|
| $0.0672 / seconde |
| $0.0896 / seconde |
| $0.419 / seconde |
| $0.0896 / seconde |
| $0.112 / seconde |
| $0.419 / seconde |
| $0.1008 / seconde |
| $0.1344 / seconde |
Cas d’utilisation
Placer une personne dans un lieu où elle n’a jamais été photographiée
Donnez à un visage sa propre référence et à un lieu la sienne, et décrivez l’action qui les réunit — le genre de plan qu’une seule photo de l’un ou de l’autre ne pourrait pas fournir seule.
Garder un accessoire ou une tenue cohérents entre les plans
Référencez un objet précis — un bijou, une voiture, une tenue signature — aux côtés d’une référence de personnage, et il revient correctement au lieu d’être redessiné légèrement différemment à chaque exécution.
Construire une scène autour de trois éléments planifiés
Quand un plan dépend d’une personne précise, d’un décor précis et d’un objet précis apparaissant tous ensemble — comme une lettre, une pièce et son lecteur — les références permettent de fixer les trois au lieu de les décrire depuis zéro en prose.
Guide de prompt et conseils pratiques
Numérotez chaque référence et nommez son rôle
Écrivez « l’image 1 est X, gardez Y » pour chaque référence dans l’ordre. C’est le facteur le plus déterminant pour qu’une référence se transmette proprement ou se retrouve mélangée avec les autres.
Préférez trois ou quatre photos claires à sept qui se recoupent
Plus de références n’est pas automatiquement mieux. Une poignée de photos claires et distinctes — une pour le visage, une pour la tenue, une pour la pièce — préserve mieux l’identité que sept photos qui se recoupent dans ce qu’elles montrent.
Décrivez le son comme une couche de fond
Quand vous demandez une ambiance comme la pluie ou les roues d’un train aux côtés d’un dialogue, attendez-vous à ce qu’elle reste discrète dans le mixage. Si l’ambiance doit être marquée, dites-le explicitement plutôt que de la lister brièvement à côté du dialogue.
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/o3/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












