Introduction
FLUX 3 image vers vidéo anime une image fixe avec le modèle vidéo FLUX 3 de Black Forest Labs. Donnez-lui une image d’ouverture et, si vous le souhaitez, une image de fermeture ; il écrit de 5 à 20 secondes de mouvement avec un son synchronisé, en 720p ou 1080p.
Choisir un mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | FLUX 3, texte vers vidéo |
| une image fixe à animer, avec une dernière image facultative | FLUX 3, image vers vidéo |
| un clip à prolonger | FLUX 3, prolongation de vidéo |
| un clip à agrandir | FLUX 3, agrandissement de vidéo |
Fonctionnalités et points forts
L’image fixe le rendu
La personne, la tenue et le décor viennent de l’image d’ouverture : le prompt n’a donc qu’à décrire l’action, la caméra et le son.
Image d’ouverture et de fermeture
Avec une dernière image, le clip va de l’une à l’autre. Des images proches par la lumière et la position se fondent en douceur ; des images très éloignées peuvent produire une coupe franche au milieu.
Le format suit l’image
Omettez le ratio d’image et le clip garde le format de l’image d’ouverture.
Facturation à la seconde
Le prix suit la durée et le niveau (draft le moins cher, puis standard 720p, puis standard 1080p) ; une dernière image et le réglage du son ne coûtent rien de plus.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Décrivez ce qui se passe après l’image d’ouverture : l’action, le mouvement de caméra et une ligne Sound:. 1 caractères minimum · 5000 caractères maximum |
image_url | Oui | L’image d’ouverture, importée ou liée. Le sujet garde son apparence d’après cette image. 1 caractères minimum |
last_image_url | Non | Image de fermeture facultative. 1 caractères minimum |
aspect_ratio | Non | L’un des formats 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 ou 2:1. Omettez-le pour suivre l’image d’ouverture. |
quality | Non | standard (par défaut) rend à la résolution choisie ; draft est un aperçu rapide et moins coûteux, toujours en 720p ( |
resolution | Non | 720p (par défaut) ou 1080p. Le 1080p coûte plus cher. |
duration_seconds | Non | Durée en secondes entières, de 5 à 20 ; 5 par défaut. Facturée à la seconde : elle fixe donc le prix avec le niveau. |
generate_audio | Non | Génère un son synchronisé avec l’image. Activé par défaut ; désactivé, il donne un fichier muet. Valeur par défaut: |
Tarification
Facturé à la seconde de vidéo, selon le niveau : le draft est le moins cher, puis le standard en 720p, puis le standard en 1080p. Avec ou sans son, le prix est le même, et le ratio d’image ne le change pas. Les demandes refusées ou en échec ne sont pas facturées. Ajouter une dernière image ne change pas le prix.
| Résolution | Qualité: Brouillon | Qualité: Standard |
|---|---|---|
| $0.06 / seconde | $0.29 / seconde |
| $0.06 / seconde | $0.17 / seconde |
Cas d’utilisation
Donner vie aux portraits
Un sourire, un mouvement de tête, du vent dans les cheveux, avec le son de pièce qui va avec.
Mouvements avant et après
Un changement d’heure du jour ou de pose entre une image de départ et une image d’arrivée.
Produits et lieux
Un lent arc de caméra autour d’un sujet dont vous avez déjà une photo.
Guide de prompt et conseils pratiques
Décrivez le mouvement, pas l’image
L’image montre déjà qui et où ; écrivez ce qui change.
Gardez les deux images proches
Une lumière et un placement semblables donnent un mouvement fluide ; des images très différentes sont plutôt reliées par une coupe.
Ne comptez pas sur la formule « un seul plan »
Demander un plan continu ne le garantit pas : vérifiez le résultat.
Attendez-vous à une légère dérive du visage sur les longs mouvements
Le visage peut bouger un peu lors de grands mouvements de tête ou quand des mains le croisent.
Prévisualisez en draft
Testez le mouvement en draft avant un rendu complet.
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": "black-forest-labs/flux-3/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",
"quality": "standard",
"resolution": "720p"
}
}'
# 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.


























