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 · 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 | 17,31 | 0,17 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 18 crediti per immagine (0,18 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 Flex 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-flex/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-flex/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 Flex
Quanto costa l’API di FLUX.2 Flex?
FLUX.2 Flex costa da 18 crediti (0,18 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 Flex nell’API?
Inserisci black-forest-labs/flux-2-flex/text-to-image per Crea immagine; black-forest-labs/flux-2-flex/edit per Modifica immagine nel campo model di POST /jobs/createTask.
In che cosa eccelle FLUX.2 [flex]?
Lettering e impaginazione. Nei nostri test un poster di film con titolo, slogan e riga di uscita, una copertina di album con un titolo in corsivo e l’etichetta di una latta di tè sono tornati tutti con ogni riga tra virgolette scritta come indicato.
I codici colore esadecimali funzionano?
Per lo più. Un codice accanto a un oggetto grande o al color grading viene seguito da vicino; su una piccola riga di lettering la tonalità può cambiare. Nel nostro test del poster la riga di uscita era richiesta in un rosso intenso ed è tornata in un salmone più chiaro.
Posso regolare passi o guidance?
No. Queste impostazioni qui non sono disponibili. Controlli il risultato con il prompt, la proporzione, il livello di dimensione e il seed.
Perché la modifica si ferma a 1k?
Nei nostri test le modifiche con più immagini di partenza a 2k continuavano a fallire, quindi la modifica è offerta solo a 1k. Il testo in immagine offre sia 1k sia 2k.
FLUX.2 [flex] o un altro modello FLUX.2?
Scegli flex quando l’immagine ruota soprattutto attorno a testo e impaginazione. Gli altri modelli FLUX.2 bilanciano in modo diverso velocità, realismo e apertura; confrontali nelle pagine della famiglia FLUX.2.
Quali sono i limiti dell’API di FLUX.2 Flex?
Risoluzioni: 1K; 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 Flex senza scrivere codice?
Sì. Il Playground esegue FLUX.2 Flex 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ù veloce ed economico per il lavoro fotografico con meno testo.
- 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

