Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Predefinito: auto |
image_urls | Sì | Foto da modificare o combinare. Spiega nel prompt cosa aggiunge ciascuna. |
prompt | Sì | Say what to change and what must stay the same. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 1k · 2k · Predefinito: 1k |
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
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 |
|---|---|---|
| Standard | 8,67 | 0,087 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 9 crediti per immagine (0,09 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
- 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-pro/edit 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-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"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 9 crediti (0,09 USD) per immagine con Modifica immagine, il suo task più economico. 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: auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 +4; Immagini di riferimento: 3; Lunghezza del prompt (caratteri): 5,000; Caricamento massimo: 10 MB. 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à.
- 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

