Introduzione
FLUX.2 [pro] Testo in immagine è il modello di produzione di Black Forest Labs della generazione FLUX.2, rilasciato il 25 novembre 2025. Trasforma un prompt scritto in un’immagine fotografica a 1k o 2k in nove proporzioni, con testo che si legge correttamente dentro l’immagine e colori impostabili con codici esadecimali.
Scegli la modalità in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| una descrizione scritta | FLUX.2 [pro] Testo in immagine |
| da una a tre immagini da modificare o combinare | FLUX.2 [pro] Modifica |
Caratteristiche principali
Testo leggibile nell’immagine
Metti le parole tra virgolette e indica dove si trovano. Nel nostro test del poster un titolo con grazie e una piccola riga senza grazie sono usciti entrambi scritti esattamente come indicato.
Colori controllati con codici esadecimali
Scrivi i colori come codici esadecimali e la palette li segue. Il nostro poster usava un verde acqua e un tono rame, e il mare e la fascia dell’orizzonte li hanno assunti.
Realismo da documentario
Grana della pelle, luce di finestra e grana da pellicola sembrano fotografie. Il nostro ritratto sul balcone ha mantenuto lentiggini e rughe sottili a 2k.
Con moderazione e limiti
Il livello Lieve viene renderizzato. Nei nostri test il livello Moderato è stato renderizzato in alcune esecuzioni e restituito attenuato in altre, le richieste di livello Forte sono tornate attenuate e il livello Molto forte è stato rifiutato senza addebito.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, fino a 5.000 caratteri. Descrivi soggetto, abbigliamento, ambientazione, luce e obiettivo in frasi semplici. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Una di nove forme: 1:1 (predefinito), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. La forma non cambia il prezzo. |
resolution | No | 1k (predefinito) è circa un megapixel; 2k è 2048 pixel sul lato lungo. Il livello di dimensione incide sul prezzo. |
seed | No | Numero intero facoltativo da 0 a 2147483647. Riutilizzalo mentre cambi il prompt per confrontare le variazioni fianco a fianco; non garantisce un’immagine identica. |
Prezzi
Addebitato per immagine in base al livello di dimensione; la proporzione non cambia il prezzo. Le richieste rifiutate e fallite non vengono addebitate.
| Specifiche | Prezzo |
|---|---|
| $0.03 / immagine |
| $0.0391 / immagine |
Casi d’uso
Poster e bozze di campagna
Un titolo, uno slogan e una fotografia nella stessa inquadratura, per concept di fragranze, moda o prodotti.
Ritratti di coppie e di personaggi
Due persone con capelli, abiti e atmosfera distinti in una scena spontanea, per storie, moodboard e schede personaggio.
Visual social in qualsiasi formato
Inquadrature quadrate, verticali, panoramiche e ultra panoramiche dallo stesso prompt, cambiando la forma.
Consigli avanzati
Scrivi frasi complete
Soggetto, abbigliamento, ambientazione, luce e obiettivo in frasi funzionano meglio di un elenco di parole chiave.
Metti il testo tra virgolette e indicane lo stile
Metti ogni riga tra virgolette e descrivi il carattere, per esempio un titolo con grazie ben spaziato in alto.
Fissa la palette
Indica i codici esadecimali dei due o tre colori che contano e di’ dove compaiono.
Fai le bozze a 1k
Prova una composizione a 1k, poi renderizza a 2k quella buona. Il livello di dimensione incide sul prezzo.
Usa un seed per confrontare
Tieni fisso il seed mentre cambi una frase, così le differenze dipendono solo dalle tue parole.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
























