Introduction
FLUX.2 [max] texte vers image est le modèle de la plus haute qualité de la famille FLUX.2 de Black Forest Labs, sorti le 16 décembre 2025, et génère des images à partir d’un prompt écrit. Il est conçu pour les personnes et la lumière photoréalistes, le texte lisible à l’intérieur de l’image et les couleurs définies en valeurs hex, en 1k ou 2k, dans neuf ratios.
Choisir un mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | FLUX.2 Max, texte vers image |
| une à trois photos à modifier ou à combiner | FLUX.2 Max, retouche |
Fonctionnalités et points forts
Personnes et lumière photoréalistes
Le brillant des tissus, la texture de la peau, la faible profondeur de champ ainsi qu’un objectif et une direction de lumière nommés ressortent nettement. Dans nos tests, une robe de soie dos nu à l’heure bleue et un couloir d’hôtel des années 1970 se lisaient tous deux comme des photographies.
Texte et couleurs hex
Mettez chaque ligne de texte entre guillemets et dites où elle se place. Notre exemple de couverture de magazine a rendu un titre, des accroches et une ligne de numéro exactement comme écrits, sur un fond défini par une valeur hex.
Deux niveaux de taille, neuf formats
Le 1k fait environ un mégapixel et le 2k atteint 2 048 pixels sur le grand côté, du carré au 21:9 et au 9:21. Le format ne change pas le prix.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Décrivez le sujet, la tenue, le décor, l’objectif et la lumière en phrases simples. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | L’un des neuf formats, du 21:9 au 9:21 ; 1:1 par défaut. Le format ne change pas le prix. |
resolution | Non | Le 1k (par défaut) fait environ un mégapixel ; le 2k atteint 2 048 pixels sur le grand côté. Le 2k coûte plus cher que le 1k. |
seed | Non | Entier facultatif de 0 à 2147483647. Réutilisez-le avec le même prompt pour comparer plus facilement les changements ; il ne garantit pas une image identique. |
Tarification
Facturé à l’image selon le niveau de taille ; le 2k coûte plus cher que le 1k, et le ratio d’image ne change pas le prix. Les requêtes échouées ou refusées ne sont pas facturées.
| Spécification | Prix |
|---|---|
| $0.07 / image |
| $0.0881 / image |
Cas d’utilisation
Portraits éditoriaux et de campagne
Portraits de mode, de lifestyle et de marque pour planches d’ambiance, présentations commerciales et ébauches de campagne.
Couvertures, affiches et étiquettes
Couvertures de magazine, affiches d’événement et packagings où plusieurs éléments de texte partagent le cadre avec une image.
Photogrammes cinématographiques
Cadres grand écran avec un objectif, une lumière et un étalonnage décrits, pour des storyboards et des visuels clés.
Guide de prompt et conseils pratiques
Rédigez-le comme un brief photo
Sujet, tenue, décor, objectif, direction de la lumière et étalonnage, en phrases complètes.
Citez et positionnez tout le texte
Chaque mot qui doit apparaître va entre guillemets avec sa position ; les mots sans guillemets sont traités comme de la description.
Donnez les couleurs en valeurs hex
#0F5C4A pour une robe ou #4A0E1A pour un fond est suivi de plus près qu’un nom de couleur.
Restez sur les scènes au niveau Léger
Le filtre de contenu laisse passer les scènes au niveau Léger, atténue généralement tout ce qui est plus fort et refuse les demandes Très fort. Les requêtes refusées ne sont pas facturées.
Comptez de 20 à 90 secondes
La plupart de nos requêtes se sont terminées dans cet intervalle ; le 2k et une file chargée demandent plus de temps.
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-max/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.

























