Introduction
FLUX.2 [pro] texte vers image est le modèle de production de Black Forest Labs issu de la génération FLUX.2, sorti le 25 novembre 2025. Il transforme un prompt écrit en image photographique en 1k ou 2k, dans neuf ratios, avec un texte correctement écrit dans l’image et des couleurs que l’on fixe avec des codes hex.
Choisir un mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | FLUX.2 [pro], texte vers image |
| une à trois images à modifier ou à combiner | FLUX.2 [pro], retouche |
Fonctionnalités et points forts
Du texte lisible dans l’image
Mettez les mots entre guillemets et dites où ils se placent. Dans notre test d’affiche, un titre à empattements et une petite ligne sans empattement sont tous deux revenus orthographiés exactement comme écrits.
Contrôle des couleurs par code hex
Écrivez les couleurs en codes hex et la palette suit. Notre affiche utilisait un bleu-vert et un cuivre, que la mer et la bande d’horizon ont repris.
Réalisme documentaire
La texture de la peau, la lumière de fenêtre et le grain argentique se lisent comme des photographies. Notre portrait au balcon a conservé les taches de rousseur et les fines rides en 2k.
Avec modération, et des limites
Le niveau Léger s'affiche. Dans nos tests, le niveau Modéré s'est affiché dans certains essais et est revenu adouci dans d'autres, les demandes de niveau Fort sont revenues adoucies, et le niveau Très fort a été refusé sans facturation.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 5 000 caractères. Décrivez le sujet, les vêtements, le décor, la lumière et l’objectif en phrases simples. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | L’un des neuf formats : 1:1 (par défaut), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. Le format ne change pas le prix. |
resolution | Non | Le 1k (par défaut) fait environ un mégapixel ; le 2k fait 2 048 pixels sur le grand côté. Le niveau de taille influe sur le prix. |
seed | Non | Entier facultatif de 0 à 2147483647. Réutilisez-le en changeant le prompt pour comparer des variantes côte à côte ; il ne garantit pas une image identique. |
Tarification
Facturé à l’image selon le niveau de taille ; le ratio d’image ne change pas le prix. Les requêtes refusées ou échouées ne sont pas facturées.
| Spécification | Prix |
|---|---|
| $0.03 / image |
| $0.0391 / image |
Cas d’utilisation
Affiches et ébauches de campagne
Un titre, une accroche et une photographie dans un même cadre, pour des concepts de parfum, de mode ou de produit.
Portraits de couples et de personnages
Deux personnes aux cheveux, aux vêtements et à l’humeur distincts dans une scène spontanée, pour des histoires, des planches d’ambiance et des fiches de personnage.
Visuels pour les réseaux dans tous les formats
Cadres carrés, verticaux, larges et ultra-larges à partir du même prompt en changeant simplement le format.
Guide de prompt et conseils pratiques
Écrivez des phrases complètes
Sujet, vêtements, décor, lumière et objectif en phrases fonctionnent mieux qu’une liste de mots-clés.
Citez le texte et nommez son style
Mettez chaque ligne entre guillemets et décrivez les caractères, par exemple un titre à empattements très espacés en haut.
Fixez la palette
Donnez des codes hex pour les deux ou trois couleurs qui comptent et dites où elles apparaissent.
Faites vos brouillons en 1k
Testez une composition en 1k, puis rendez la bonne version en 2k. Le niveau de taille influe sur le prix.
Utilisez un seed pour comparer
Gardez le seed fixe pendant que vous changez une seule formule, afin que les différences viennent de votre formulation.
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-2-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# 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.
























