Prendi la chiave API

di Black Forest Labs

Immagini fotorealistiche con testo leggibile e colori in esadecimale

black-forest-labs/flux-2-pro/text-to-imageDa 5 creditiper immagine · 0,05 USD
  • Fino a 2K
  • Fino a 3 immagini di riferimento
  • 9 formati
  • Crea immagine
  • Modifica immagine
City in a BubbleGuarda gli esempi

Informazioni su FLUX.2 Pro

FLUX.2 [pro] è il modello di produzione della famiglia FLUX.2 di Black Forest Labs, rilasciato il 25 novembre 2025. Punta al realismo fotografico, a un testo che si legge correttamente nell’immagine e a colori che puoi fissare con codici esadecimali, e modifica con fino a tre immagini di riferimento. Addebito per immagine.

Lo chiami con il nome di modello black-forest-labs/flux-2-pro/text-to-image su POST /jobs/createTask, da 5 crediti per immagine (0,05 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.

Per ora questa guida è solo in inglese. →

Parametri della richiesta

ParametroObbligatorioDescrizione
seedNoLo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647
promptSìDescribe the subject, setting, light and style in plain sentences.
resolutionNoDimensione dell'output. Più grande è più nitido e costa di più. 1k · 2k · Predefinito: 1k
aspect_ratioNoLa forma dell'inquadratura: larga, quadrata o verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Predefinito: 1:1

Prezzi

I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.

OpzioneCrediti per immagine≈ USD
resolution 1K4,50,045 USD
resolution 2K5,870,059 USD

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 5 crediti per immagine (0,05 USD).

Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.

Guida rapida all'API

Chiama l'API di FLUX.2 Pro in tre passaggi

  1. Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
  2. Invia la richiesta. Invia POST /jobs/createTask con model black-forest-labs/flux-2-pro/text-to-image e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
  3. Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.

Domande sull’API di FLUX.2 Pro

Quanto costa l’API di FLUX.2 Pro?

FLUX.2 Pro costa da 5 crediti (0,05 USD) per immagine con Crea immagine, il suo task più economico. Prezzi per opzione: 1K 4,5 crediti per immagine, 2K 5,87 crediti per immagine. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.

Qual è il nome del modello di FLUX.2 Pro nell’API?

Inserisci black-forest-labs/flux-2-pro/text-to-image per Crea immagine; black-forest-labs/flux-2-pro/edit per Modifica immagine nel campo model di POST /jobs/createTask.

Che cos’è FLUX.2 [pro]?

È il modello di livello produttivo della seconda generazione FLUX di Black Forest Labs, rilasciato il 25 novembre 2025, pensato per bilanciare qualità e velocità. A marzo 2026 Black Forest Labs lo ha reso circa due volte più veloce.

Riesce a scrivere testo nelle immagini?

Sì. Nel nostro test del poster abbiamo messo tra virgolette un titolo e una piccola riga ed entrambi sono tornati scritti esattamente come indicato, nello stile di carattere descritto dal prompt. Metti le parole tra virgolette e indica dove si trovano.

Segue i codici colore?

Sì. I codici esadecimali scritti nel prompt guidano la palette. Nel nostro test del poster un verde acqua del crepuscolo e una fascia d’orizzonte color rame sono usciti nei toni che avevamo indicato.

Quante immagini di riferimento posso usare?

Da una a tre in una modifica. Indica che cosa porta ciascuna: l’immagine 1 è la persona, l’immagine 2 il prodotto, l’immagine 3 il luogo.

Il seed ripete un’immagine?

Un seed fisso serve a confrontare i prompt fianco a fianco; non garantisce un risultato identico.

Quali sono i limiti dell’API di FLUX.2 Pro?

Risoluzioni: 1K · 2K; Proporzioni: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Lunghezza del prompt (caratteri): 5,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.

Posso provare FLUX.2 Pro senza scrivere codice?

Sì. Il Playground esegue FLUX.2 Pro con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

Tutti i modelli FLUX

FLUX.2 Max è il livello di massima qualità per i ritratti principali; FLUX.2 Flex è quello per molto testo. Pro bilancia qualità e velocità.

Altro su FLUX.2 Pro