Introduction
Le mode édition vidéo de Kling 4.0 Flash part d’un clip existant et d’une consigne obligatoire précisant le changement souhaité. Fournissez une source de 3–20 secondes et, si utile, jusqu’à 10 images de référence. Le résultat 720p conserve la scène, le sujet, le mouvement et le déplacement de caméra de la source tout en appliquant la modification décrite.
La durée du résultat suit celle de la source ; les sources de plus de 20 secondes sont coupées à cette limite. Lors de nos essais, l’édition de la tenue dans l’observatoire a conservé la durée source de 5,04 secondes. Le son source reste présent par défaut ; passez keep_original_audio à false pour générer un nouveau son synchronisé.
Fonctionnalités et points forts
- Construisez une variante visuelle autour d’une interprétation et d’un mouvement de caméra existants.
- Fournissez jusqu’à 10 images si la modification nécessite une référence visuelle précise.
- Retrouvez le rythme de la source dans le résultat, avec une limite de 20 secondes pour le matériau source.
- Gardez la bande sonore d’origine par défaut ou générez un nouveau son synchronisé.
- Obtenez un résultat 720p au cadrage auto ou dans l’un des quatre formats d’image disponibles.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Consignes de modification obligatoires, sans texte prédéfini ; précisez le changement et la scène, le sujet, le mouvement et le déplacement de caméra à conserver. 1 caractères minimum |
video_url | Oui | URL obligatoire d’un clip source de 3–20 secondes, sans source prédéfinie ; les entrées plus longues sont coupées à 20 secondes. 1 caractères minimum |
reference_image_urls | Non | Ajoutez, si nécessaire, jusqu’à 10 URL d’images pour guider la modification, en les désignant par @Image1, @Image2, etc., dans l’ordre d’import. 1 éléments minimum · 10 éléments maximum |
aspect_ratio | Non | Utilisez auto pour suivre la vidéo source, ou réglez le format de sortie sur 16:9, 9:16, 1:1 ou 21:9. Ce paramètre ne modifie pas le coût de l’édition. |
keep_original_audio | Non | La valeur par défaut true conserve le son source ; false génère une nouvelle bande sonore synchronisée. Modifier cette valeur n’entraîne aucuns frais supplémentaires. Valeur par défaut: |
Tarification
$0.151 / seconde
L’édition est facturée selon les secondes source arrondies à la seconde entière supérieure, dans la limite de 20 secondes facturées. Une source de 5,04 secondes compte pour 6 secondes facturées, même si la sortie reste à 5,04 secondes. Le prompt, les images de référence, le format d’image et le choix sonore ne donnent lieu à aucun supplément. Les refus de la modération de Kling ne font l’objet d’aucune facturation.
Cas d’utilisation
- Essayez une robe de soirée émeraude dans un clip d’observatoire en conservant l’action.
- Évaluez plusieurs couleurs de manteau dans les versions d’une courte scène sociale.
- Préparez des variantes visuelles d’un mouvement filmé en gardant la bande sonore source.
Guide de prompt et conseils pratiques
- Commencez par ce qu’il faut conserver, comme « préservez la scène et le mouvement de caméra », pour fixer les éléments stables de l’édition.
- Ciblez une modification, comme « donnez au manteau une couleur gris anthracite », avant de demander plusieurs variantes.
- Attribuez un rôle à chaque image ajoutée, comme « utilisez la veste de @Image1 », pour relier la référence au changement.
- Décrivez ensemble la matière et la couleur, comme « une robe en velours émeraude », lorsque la tenue fait l’objet de la modification.
- Pour obtenir une nouvelle bande sonore, désactivez
keep_original_audioet ajoutez une indication comme « Son : grondement sourd d’un moteur et vent du soir ».
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/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
