Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
prompt | Sì | Describe the image you want. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 1k · 2k · 4k · Predefinito: 1k |
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · Predefinito: 16:9 |
output_format | No | Tipo di file del risultato. png · jpeg · Predefinito: png |
enable_web_search | No | Controlla prima sul web date, luoghi e fatti recenti. Predefinito: false |
enable_image_search | No | Cerca prima foto reali di un luogo o di un prodotto. Predefinito: false |
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 | 7,2 | 0,072 USD |
| resolution 2K | 10,8 | 0,11 USD |
| resolution 4K | 24,3 | 0,24 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 8 crediti per immagine (0,08 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 Nano Banana 2.1 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 google/nano-banana-2.1/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": "google/nano-banana-2.1/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "16:9",
"resolution": "1k",
"output_format": "png"
}
}'
# 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 Nano Banana 2.1
Quanto costa l’API di Nano Banana 2.1?
Nano Banana 2.1 costa da 8 crediti (0,08 USD) per immagine con Crea immagine, il suo task più economico. Prezzi per opzione: 1K 7,2 crediti per immagine, 2K 10,8 crediti per immagine, 4K 24,3 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 Nano Banana 2.1 nell’API?
Inserisci google/nano-banana-2.1/text-to-image per Crea immagine; google/nano-banana-2.1/edit per Modifica immagine nel campo model di POST /jobs/createTask.
È il Nano Banana 2.1 di Google?
Sì. Le richieste girano sul modello che Google ha rilasciato il 6 ottobre 2026 come Nano Banana 2.1, un aggiornamento di Nano Banana 2 (Gemini 3.1 Flash Image). Gli output a 1K, 2K e 4K corrispondono alle dimensioni che Google pubblica per questo modello.
Nano Banana 2.1 o Nano Banana 2?
2.1 è il modello più recente: Google ha migliorato qualità dell’immagine, aderenza al prompt, coerenza dei personaggi e resa del testo, e dice di aver eliminato le giunzioni nei banner larghi a 2K e 4K. Nano Banana 2 mantiene un livello bozza 0.5K che 2.1 non ha. Entrambi offrono ricerca web e immagini e fino a quattordici riferimenti. Google ha dichiarato obsoleto Nano Banana 2 (nessuna data di chiusura annunciata) e consiglia di passare a 2.1.
Come rende il testo?
Ogni riga che abbiamo messo tra virgolette è uscita scritta come l’avevamo scritta: una testata di rivista con due titoli di copertina, un titolo di film con la riga della data di uscita, un’insegna al neon di un motel e il titolo di un album disegnato su una custodia vuota in una modifica. Le scritte minute che non avevamo specificato, come quelle sotto il titolo di un poster o un codice a barre, sono uscite come testo di riempimento.
Quanto sono grandi le immagini?
A 1:1 i livelli misurano 1024, 2048 e 4096 pixel di lato. Gli altri formati mantengono circa lo stesso numero di pixel: nei nostri test 3:4 a 1k è tornato a 896 × 1200, 16:9 a 2k a 2752 × 1536 e un banner 8:1 a 2k a 5856 × 704.
Quali sono i limiti dell’API di Nano Banana 2.1?
Risoluzioni: 1K · 2K · 4K; Proporzioni: 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 +8; Lunghezza del prompt (caratteri): 5,000. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Nano Banana 2.1 senza scrivere codice?
Sì. Il Playground esegue Nano Banana 2.1 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Nano Banana
Nano Banana Pro pianifica l'impaginazione prima di disegnare, quindi gestisce con più cura testi fitti, diagrammi e lavori in più parti. Nano Banana 2.1 è più recente, più veloce e costa meno della metà per immagine, e in più offre banner 8:1 e la ricerca web e per immagini.
- API di Nano Banana 2.1La Nano Banana più recente di Google, testo nitido e output 4KDa 8 crediti per immagine
- API di Nano Banana ProPensa prima all’impaginazione: tanto testo, schemi e modifiche in 4KDa 17 crediti per immagine
- API di Nano Banana 2Immagini Gemini veloci fino al 4K, con fino a 14 riferimentiDa 6 crediti per immagine

