Prendi la chiave API

di Black Forest Labs

Il FLUX di punta: luce fotorealistica e colori di brand esatti

black-forest-labs/flux-2-max/text-to-imageDa 11 creditiper immagine · 0,11 USD
  • Fino a 2K
  • Fino a 3 immagini di riferimento
  • 9 formati
  • Crea immagine
  • Modifica immagine

Informazioni su FLUX.2 Max

FLUX.2 [max] è il modello di qualità più alta della linea FLUX.2 di Black Forest Labs, rilasciato il 16 dicembre 2025. Rende ritratti fotorealistici, luce, testo leggibile nell’immagine e valori di colore esadecimali, e modifica con fino a tre immagini di riferimento a 1k o 2k, fino a 2048 pixel sul lato lungo, in nove proporzioni.

Lo chiami con il nome di modello black-forest-labs/flux-2-max/text-to-image su POST /jobs/createTask, da 11 crediti per immagine (0,11 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 1K10,50,11 USD
resolution 2K13,210,13 USD

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 11 crediti per immagine (0,11 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 Max 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-max/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-max/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 Max

Quanto costa l’API di FLUX.2 Max?

FLUX.2 Max costa da 11 crediti (0,11 USD) per immagine con Crea immagine, il suo task più economico. Prezzi per opzione: 1K 10,5 crediti per immagine, 2K 13,21 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 Max nell’API?

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

Che cos’è FLUX.2 [max]?

È il modello di qualità più alta della famiglia FLUX.2 di Black Forest Labs, rilasciato il 16 dicembre 2025. È pensato per persone e luce fotorealistiche, testo leggibile nell’immagine e modifiche che combinano più riferimenti.

Riesce a scrivere testo nelle immagini?

Sì. Il nostro esempio di copertina di rivista ha reso una testata, un titolo di copertina e una riga del numero, tutti scritti come indicato. Metti ogni riga tra virgolette e indica dove si trova. I valori di colore esadecimali nel prompt vengono seguiti con precisione.

Quante immagini di riferimento posso usare?

Da una a tre. Nel prompt chiamale immagine 1, immagine 2 e immagine 3 e indica che cosa porta ciascuna. Il nostro esempio della libreria ha inserito due donne da ritratti separati in una terza foto di una stanza.

Che cosa fa auto nelle modifiche?

Con auto il risultato mantiene la proporzione della prima immagine di partenza a circa un megapixel. Se scegli invece una proporzione, puoi usare 1k o 2k.

Cerca sul web o accetta impostazioni di passi e guidance?

No. Questi controlli qui non sono disponibili. Hai a disposizione il prompt, la proporzione, il livello di dimensione e il seed.

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

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 Max senza scrivere codice?

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

Tutti i modelli FLUX

FLUX.2 Pro è più economico e più veloce per l'uso di tutti i giorni. Max è quello per i ritratti principali e le copertine.

Altro su FLUX.2 Max