Introduction
FLUX 3 texte vers vidéo est le modèle vidéo de Black Forest Labs, dont l’API ouvre le 4 août 2026. Il transforme un prompt écrit en clip de 5 à 20 secondes avec son synchronisé, en 720p ou 1080p dans sept formats, et propose un niveau draft rapide pour vérifier un plan au prix le plus bas.
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 et le son ensemble
Le son est généré dans la même passe que l’image. Les dialogues entre guillemets correspondaient mot pour mot à nos prompts, et une ligne Sound: oriente les bruits d’ambiance comme la pluie ou les pas. Désactiver le son ne change pas le prix.
Niveau draft
Le draft est un aperçu rapide et moins coûteux, toujours en 720p. Les détails sont plus doux qu’en standard, mais cela suffit pour juger le cadrage, l’action et l’ambiance avant le rendu complet.
Facturation à la seconde
Le prix suit la durée et le niveau : le draft est le moins cher, puis le standard en 720p, puis le standard en 1080p. Le ratio d’image et le réglage du son ne le changent pas, et les demandes refusées ou en échec ne sont pas facturées.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Décrivez le sujet, l’action, la caméra, la lumière et le son ; ajoutez une ligne Sound: pour les bruits d’ambiance et mettez les paroles entre guillemets. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | L’un des formats 16:9 (par défaut), 9:16, 1:1, 4:3, 3:4, 21:9 ou 2:1. Le format ne change pas le prix. |
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.
| Résolution | Qualité: Brouillon | Qualité: Standard |
|---|---|---|
| $0.06 / seconde | $0.29 / seconde |
| $0.06 / seconde | $0.17 / seconde |
Cas d’utilisation
Scènes de dialogue et d’ambiance
Un personnage, une réplique, un son de pièce et un lent mouvement de caméra.
Storyboards
Prévisualisez chaque plan en draft, puis refaites ceux que vous gardez.
Clips sociaux et verticaux
Le 9:16 et le 1:1 sont disponibles, et le 21:9 et le 2:1 couvrent les cadres larges de cinéma.
Guide de prompt et conseils pratiques
Écrivez comme pour un plan
Le sujet et la tenue, le décor, l’action, le mouvement de caméra, la lumière, puis une dernière ligne commençant par Sound:.
Mettez les dialogues entre guillemets
Placez les paroles entre guillemets, dans la langue que vous voulez entendre.
Une action par clip
Une seule action claire et un seul mouvement de caméra tiennent le mieux ; de grands changements de lumière ou de lieu peuvent pousser le modèle à couper ou à enchaîner en fondu.
Commencez par le draft
Réglez le cadrage en draft, puis lancez le même prompt en standard.
Gardez des attentes réalistes sur le contenu
Seuls les rendus de niveau Léger sont produits ; tout ce qui est plus fort est refusé et non facturé.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"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.


























