Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
prompt | Sì | Describe the subject, setting, light and style in plain sentences. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 1k · 2k · Predefinito: 1k |
aspect_ratio | No | La 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.
| Opzione | Crediti per immagine | ≈ USD |
|---|---|---|
| resolution 1K | 10,5 | 0,11 USD |
| resolution 2K | 13,21 | 0,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
- 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.
- 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à.
- 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.
- API di FLUX.2 MaxIl FLUX di punta: luce fotorealistica e colori di brand esattiDa 11 crediti per immagine
- API di FLUX 3Video con audio sincronizzato e un livello bozza veloceDa 45 crediti per una clip di 5 secondi
- API di FLUX.2 Klein 9B LoRAFLUX.2 Klein 9B veloce che carica fino a tre tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein Base 9B LoRAKlein 9B non distillato per look vari con le tue LoRADa 4 crediti per immagine
- API di FLUX.2 Klein 4B LoRAFLUX.2 Klein 4B piccolo e veloce con le tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein Base 4B LoRAKlein 4B non distillato che carica le tue LoRADa 3 crediti per immagine
- API di FLUX.2 Klein 9BModifiche FLUX veloci che preservano volti e poseDa 2 crediti per immagine
- API di FLUX.2 Klein 4BIl FLUX più piccolo e rapido, per bozze velociDa 2 crediti per immagine
- API di FLUX.2 Dev LoRAImmagini e modifiche FLUX.2 Dev con le tue LoRADa 4 crediti per immagine
- API di FLUX.2 ProImmagini fotorealistiche con testo leggibile e colori in esadecimaleDa 5 crediti per immagine
- API di FLUX.2 FlexScrive titoli ed etichette esattamente come li hai scrittiDa 9 crediti per immagine
- API di FLUX.2 DevFLUX a pesi aperti che unisce più persone in una scenaDa 2 crediti per immagine
- API di FLUX.1 Krea Dev LoRAFLUX.1 Krea fotografico con le tue LoRADa 4 crediti per immagine
- API di FLUX.1 Dev ControlNet LoRAControllo di posa, profondità o contorni su FLUX.1, con le tue LoRADa 6 crediti per immagine
- API di FLUX.1 Fill Dev LoRAInpainting a maschera su FLUX.1 Fill con le tue LoRADa 7 crediti per immagine
- API di FLUX.1 Dev LoRAIl classico FLUX.1 Dev con fino a tre tue LoRADa 3 crediti per immagine
- API di FLUX.1 Schnell LoRAFLUX.1 Schnell veloce che carica le tue LoRADa 1 credito per immagine
Altro su FLUX.2 Max
- Confronta
- FLUX.2 Max vs Nano Banana Pro

