Nano Banana 2 API

Immagine AI

L'API di Nano Banana 2 è la rotta immagine veloce Gemini 3.1 Flash di Google su OmniaKey: generazione da testo e modifica con riferimento a un prezzo per chiamata contenuto.

Leggi la documentazione Ottieni la tua chiave API

Per chiamata riuscita$0,019–$0,039
OperazioniTesto in immagine
Modifica immagine
IDgemini-3.1-flash-image-preview
Vedi prezzi degli strumenti e regole di fatturazione

Il risultato apparirà qui dopo l’esecuzione del modello.

Quando usarlo

L'API di Nano Banana 2 è la rotta immagine veloce Gemini 3.1 Flash di Google su OmniaKey: generazione da testo e modifica con riferimento a un prezzo per chiamata contenuto.

Ricorri a Nano Banana 2 quando vuoi generazione di immagini Gemini rapida ed economica dentro un prodotto o un agente, e sali a Nano Banana Pro quando una modifica richiede più ragionamento.

Entrambi gli ID chiamano lo stesso prodotto con le stesse capacità e lo stesso prezzo. Puoi usare l'uno o l'altro.

Cosa fa

Testo in immagine

gemini-3.1-flash-image

Trasforma un prompt testuale in una nuova immagine.

Modifica immagine

gemini-3.1-flash-image

Modifica un'immagine esistente da un prompt e un riferimento.

In dettaglio

Gemini 3.1 Flash Image è il modello per immagini di Google su OmniaKey con l'id gemini-3.1-flash-image, noto nella famiglia come Nano Banana 2. Genera e modifica immagini, e gemini-3.1-flash-image-preview è accettato come id equivalente. Condivide i livelli per chiamata indicati con Nano Banana 2.1, ma Google lo ha deprecato il 6 ottobre 2026 nella voce del changelog che ha introdotto la 2.1, e non è stata annunciata alcuna data di dismissione, quindi oggi continua a rispondere alle richieste.

Due impostazioni nella sua pagina del modello ne spiegano il ruolo. Supporta solo il ragionamento minimal e high, con minimal come predefinito, quindi una richiesta predefinita salta gran parte del ragionamento che la 2.1 aggiunge a medium; e la sua pagina del modello copre ancora una dimensione di output 512 che la 2.1 non elenca. Nel nostro ciclo di ottobre ha prodotto le esatte due righe di testo del poster in un caso appaiato, ed è l'id verso cui punta già la maggior parte del codice esistente per immagini Gemini.

I problemi qui riguardano parole che inventa più che parole che manca. Chiesto un scenario da ceramista senza alcun testo, ha stampato SHIMPO sulla ruota; su un'infografica ha scritto una spiegazione sotto ogni passaggio e ha sbagliato due delle righe. Anche i poster sono tornati appesi a una parete. Tieni i prompt lontani da oggetti di scena di marca che tentano il modello e leggi ogni riga aggiunta prima di pubblicare.

Mantenere una pipeline esistente

Se un insieme di prompt salvato produce già fotogrammi accettati su questo id, continua a usarlo mentre si costruisce il confronto: il modello è deprecato ma ancora servito, e il suo output 512 resta sulla pagina. Riesegui un campione fisso di quei prompt su gemini-nano-banana-2.1 accanto, poi migra quando il nuovo id vince sulle tue immagini.

Poster piatti con testo esatto

Il suo caso appaiato di poster ha reso entrambe le righe richieste senza modifiche all'ortografia, e la nostra successiva prova di infografica è stato il controesempio. Scrivi il testo come righe numerate, vieta del tutto tagline e didascalie, e controlla il ritaglio, perché i nostri poster sono arrivati come un foglio appeso a una parete e hanno richiesto un ritaglio.

Scene di prodotto senza scritte

Quando uno scatto non deve riportare alcun testo, dillo e togli dalla descrizione gli oggetti di scena di marca: il nostro fotogramma da ceramista ha ripreso SHIMPO sulla ruota anche se il prompt non chiedeva nulla di scritto. Ispeziona ruote, etichette e imballaggi sullo sfondo a dimensione piena, perché il testo inventato si nasconde nelle aree piccole.

Note di test

Nel nostro test fotografico da ceramista, Nano Banana 2 ha terminato in 28 secondi ma ha stampato il nome del marchio “SHIMPO” sulla ruota anche se il prompt non chiedeva alcun testo.
Leggi il test
Nel nostro test di infografica, Nano Banana 2 ha aggiunto una spiegazione sotto ogni passaggio in una esecuzione, e due di quelle righe sono uscite sbagliate.
Leggi il test
Entrambe le esecuzioni del poster con Nano Banana 2 sono tornate come un mockup appeso a una parete grigia anziché un file piatto, quindi l'immagine ha richiesto un ritaglio prima dell'uso.
Leggi il test
Nel nostro unico caso appaiato di poster, Nano Banana 2 ha reso correttamente entrambe le righe di testo esatto richieste, senza modifiche all'ortografia.
Leggi il test
Nano Banana 2 è stato il più veloce dei tre modelli per immagini Gemini che abbiamo eseguito il 16 ottobre 2026, con una mediana di 24 secondi per immagine 2K.
Leggi il test

Limiti da considerare

Il testo di marca compare senza invito: il nostro scenario da ceramista riportava SHIMPO sulla ruota anche se il prompt non chiedeva alcun testo.
Le spiegazioni vengono inventate. Su un'infografica ha aggiunto una riga sotto ogni passaggio e ne ha sbagliate due, quindi vieta le didascalie o metti in conto un passaggio di correzione.
I poster tornano come un mockup appeso a una parete grigia anziché un file piatto, e le nostre esecuzioni hanno richiesto un ritaglio prima che l'immagine fosse utilizzabile.
Google ha deprecato questo id il 6 ottobre 2026 senza indicare una data di dismissione, quindi il nuovo lavoro va su Nano Banana 2.1 mentre il vecchio id continua a rispondere.

Confronta modelli vicini

Modello	Meglio per	Operazioni	Prezzo di listino
Nano Banana 2Questa pagina gemini-3.1-flash-image	Riprodurre output accettati da una pipeline esistente, agli stessi livelli indicati della 2.1.	Testo in immagine · Modifica immagine	$0,019–$0,039 per chiamata
Nano Banana 2.1 gemini-nano-banana-2.1	Nuovi progetti: scritte più pulite, un intervallo di dimensioni senza 512 e un livello di ragionamento predefinito più alto.	Testo in immagine · Modifica immagine	$0,019–$0,039 per chiamata
Nano Banana 2 Lite gemini-3.1-flash-lite-image	Bozze e miniature solo 1K in cui una singola dimensione fissa copre l'intero lavoro.	Testo in immagine · Modifica immagine	$0,019 per chiamata
Nano Banana Pro gemini-3-pro-image	Layout complessi e modifiche di ritratti che giustificano il livello indicato più alto a ogni dimensione.	Testo in immagine · Modifica immagine	$0,039–$0,069 per chiamata

Fonti e verifica

Guida aggiornata il 2026-10-27.

Come chiamarlo

I modelli media funzionano in modo asincrono: crea un'attività, interrogala fino al termine, poi scarica l'URL firmato dell'asset.

Crea, interroga, scarica

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gemini-3.1-flash-image-001" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"aspect_ratio": "1:1"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Prezzo

I lavori immagine sono fatturati per chiamata riuscita, non per token. I lavori falliti o annullati vengono rimborsati automaticamente.

Per chiamata riuscita

$0,019–$0,039per chiamataRisparmia 72%

image_size

1K: $0,019per chiamata
2K: $0,029per chiamata
4K: $0,039per chiamata

Altri modelli immagine Google

Nano Banana 2.1

gemini-nano-banana-2.1

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-image

Domande frequenti

Come chiamo Nano Banana 2 su OmniaKey?

Invia una POST a /v1/media/tasks con l'id del modello, type "image" e operation "generate" o "edit". Riutilizza la stessa Idempotency-Key nei tentativi, così un timeout non avvia un secondo lavoro a pagamento.

Quanto costa Nano Banana 2?

Nano Banana 2 viene fatturato $0,019–$0,039 per chiamata. Alla creazione l'importo viene pre-addebitato dal saldo prepagato e i lavori falliti o annullati vengono rimborsati automaticamente.

Perché l'API restituisce un id attività invece dell'immagine?

La latenza dei fornitori va da pochi secondi a circa un minuto, quindi OmniaKey normalizza tutte le rotte immagine in un unico flusso asincrono. Interroga GET /v1/media/tasks/{id} finché lo stato è succeeded, poi leggi l'URL firmato dell'asset.

Nano Banana 2 è ancora utilizzabile dopo la deprecazione?

Sì. Google ha contrassegnato gemini-3.1-flash-image come deprecato nel changelog del 6 ottobre 2026 senza indicare una data di dismissione, ed è ancora elencato agli stessi livelli di Nano Banana 2.1. Considera l'avviso come un motivo per pianificare una migrazione, non come un segno che oggi le richieste falliscano.

Dovrei spostare questo lavoro su Nano Banana 2.1?

Per il nuovo lavoro, sì: la 2.1 è il successore consigliato, usa medium come ragionamento predefinito e copre da 1K a 4K senza il livello 512. Se una pipeline è stabile, esegui un campione fisso dei tuoi brief su entrambi gli id e migra quando il più recente richiede meno nuovi tentativi, non prima.

Perché compare testo quando non ne ho chiesto?

Il modello riempie i vuoti. Il nostro brief da ceramista diceva niente testo e la ruota riportava comunque SHIMPO, quindi indica quali parti della scena devono restare vuote, tieni gli oggetti di scena di marca fuori dalla descrizione e ispeziona il fotogramma a dimensione piena dove si nascondono le scritte piccole.

Consuma token di ragionamento come la 2.1?

Meno per impostazione predefinita. Supporta solo il ragionamento minimal e high, con minimal come predefinito, quindi una richiesta non specificata spende molto meno in ragionamento rispetto a una richiesta alla 2.1 che parte da medium. Imposta il livello in modo esplicito quando confronti i due, altrimenti la differenza verrà letta come qualità dell'immagine.

Quali dimensioni di output sono disponibili?

1K, 2K e 4K, più l'impostazione 512 che solo questo modello elenca; la 2.1 parte da 1K. Il nome di una risoluzione descrive un livello di output, non un fotogramma quadrato, quindi indica le proporzioni nella stessa richiesta e leggi le dimensioni del file che ricevi.