Introduction
Kling 4.0 Texte vers vidéo transforme un brief écrit en clip de 3 à 30 secondes en 720p ou 1080p, en 16:9, 9:16, 1:1 ou format ultra-large 21:9. Chaque clip est livré avec une bande sonore stéréo générée dans le même passage : les dialogues écrits entre guillemets, les effets et l’ambiance. Il n’y a pas d’interrupteur audio et pas de supplément pour cela.
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 (vous êtes ici) |
| 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 |
Fonctionnalités et points forts
Jusqu’à 30 secondes en un seul plan
La durée va de 3 à 30 secondes entières, soit le double du plafond de Kling 3.0. Un long plan laisse une scène respirer — une grue lente, une traversée complète d’un décor — sans assembler des clips plus courts.
Le son est toujours activé
Chaque clip contient une bande sonore à deux canaux. Lors de nos tests, le grondement du moteur du dôme, le vent et une phrase chuchotée sont tous revenus à partir de la ligne Sound: du prompt, calés sur l’image.
Ultra-large 21:9
En plus de 16:9, 9:16 et 1:1, Kling 4.0 rend un cadre 21:9 véritable. Notre test en 1080p ultra-large est sorti en 2200x940.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez le sujet, l’action, la caméra et le son. Mettez les répliques entre guillemets et le son sur sa propre ligne. 1 caractères minimum |
aspect_ratio | Non | 16:9 (par défaut), 9:16, 1:1 ou 21:9 ultra-large. Ne modifie pas le prix. |
resolution | Non | 720p ou 1080p (par défaut 720p). Le 1080p coûte plus cher à la seconde. |
duration_seconds | Non | Secondes entières, de 3 à 30 (par défaut 5). Détermine le prix. |
Tarification
Facturé à la seconde de sortie. Le 1080p coûte plus cher à la seconde que le 720p. Chaque clip est livré avec une bande sonore stéréo, sans supplément. 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
Plans d’établissement avec son
Un paysage, un bâtiment, une route au crépuscule : décrivez le lieu, la lumière, un mouvement de caméra et l’ambiance, et le clip peut servir d’ouverture avec son déjà en place.
Scènes courtes avec une réplique parlée
Mettez la réplique entre guillemets après l’action. Une seule réplique claire par clip est plus facile à caler pour le modèle que des dialogues qui se chevauchent.
Clips verticaux pour les réseaux sociaux
Choisissez 9:16 et placez le sujet dans le tiers central ; le modèle compose pour le cadre vertical au lieu de recadrer un plan large.
Guide de prompt et conseils pratiques
Écrivez dans l’ordre où les choses se passent
Sujet et tenue, action, mouvement de caméra, ambiance, puis une ligne Sound: séparée. Notre exemple de l’observatoire suit exactement cet ordre.
Faites court, puis long
La génération est lente ; un test de 3 secondes a pris deux à quatre minutes, et les requêtes s’exécutent les unes après les autres, pas en parallèle. Trouvez le cadrage avec 3 à 5 secondes en 720p, puis rendez la version longue ou en 1080p.
Décrivez le son voulu
Comme la bande sonore est toujours générée, ne pas mentionner le son dans le prompt ne donne pas le silence ; cela donne ce que le modèle choisit. Nommez l’ambiance voulue, ou écrivez « tonalité de pièce calme ».
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.










