Nano Banana API

Immagine AI

L'API di Nano Banana è la rotta originale Gemini 2.5 Flash Image di Google su OmniaKey, con generazione da testo e modifica tramite riferimento nell'API media.

Leggi la documentazione Ottieni la tua chiave API

Per chiamata riuscita$0,019
OperazioniTesto in immagine
Modifica immagine
Vedi prezzi degli strumenti e regole di fatturazione

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

Quando usarlo

L'API di Nano Banana è la rotta originale Gemini 2.5 Flash Image di Google su OmniaKey, con generazione da testo e modifica tramite riferimento nell'API media.

Usa Nano Banana per i flussi Gemini 2.5 esistenti. Nano Banana 2 costa uguale a 1K e offre dimensioni maggiori.

Cosa fa

Testo in immagine

gemini-2.5-flash-image

Trasforma un prompt testuale in una nuova immagine.

Modifica immagine

gemini-2.5-flash-image

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

In dettaglio

Nano Banana è il modello originale Gemini 2.5 Flash Image di Google su OmniaKey, elencato come gemini-2.5-flash-image con generazione testo-immagine e modifica immagine. Nano Banana è il nome commerciale che Google dà alla generazione e modifica nativa delle immagini di Gemini, e questo è il membro più vecchio della famiglia su questa piattaforma: il catalogo gli assegna un'unica tariffa per chiamata, senza livelli per dimensione e senza alias di anteprima.

Il suo impiego più utile nel nostro lavoro non aveva nulla a che vedere con la vittoria in un confronto. Lo usavamo per creare le immagini di partenza che altri modelli poi modificavano, così nessun modello giudicava il proprio output, e un fotogramma neutro è esattamente ciò in cui un modello legacy eccelle. È anche l'ID che il codice Gemini 2.5 esistente già richiama.

Due limiti orientano la scelta. Il catalogo non elenca alcun passo 2K o 4K per questo ID, quindi un deliverable di grandi dimensioni richiede un modello diverso; e i miglioramenti introdotti successivamente da Google, sul rendering del testo, sulle immagini di riferimento e sulle modifiche multi-turno, sono sui nuovi ID. Conservate questo per continuità e per il materiale di partenza, e aprite i nuovi brief su Nano Banana 2.1 o Pro.

Fotogrammi neutri per test di modifica

Quando più modelli devono modificare la stessa immagine, create quell'immagine qui. Il nostro ciclo di sei test di ottobre ha fatto esattamente questo, così nessun modello è stato chiamato a migliorare il proprio output e il confronto è rimasto onesto. Mantenete la fonte semplice, stabilite una volta la luce e la composizione, e riutilizzate il file ovunque.

Codice Gemini 2.5 esistente

I client scritti per la generazione 2.5 continuano a funzionare senza riscrittura: stessa struttura del task, stessa operazione di modifica, una tariffa per chiamata. Fissate l'ID nella configurazione invece di inserirlo nel codice, così un passaggio successivo a gemini-nano-banana-2.1 diventa una modifica alle impostazioni più una nuova esecuzione del set di esempi.

Fotogrammi semplici di prodotto e lifestyle

I brief semplici restano utilizzabili: un oggetto, luce diurna, sfondo pulito, nessun testo fitto. Saltatelo per poster, colonne di prezzi o gruppi di persone che devono restare riconoscibili, e impiegate un modello più recente su questi task invece di forzare questo.

Limiti da considerare

Il catalogo elenca un'unica tariffa per chiamata e nessun livello per dimensione per questo ID, quindi leggete le dimensioni consegnate invece di presumere una tela 2K o 4K.
È il membro più vecchio della famiglia su questa piattaforma: il lavoro su testo, riferimenti e multi-turno introdotto successivamente da Google appartiene ai nuovi ID, non a questo.
Google afferma che le immagini generate portano un watermark SynthID, che segnala la provenienza e non dice nulla sulla correttezza dell'immagine.
Una modifica prende la fonte inline in un corpo da 1 MiB, quindi un file fotografico a dimensione piena richiede un ridimensionamento prima che il task possa essere creato.

Confronta modelli vicini

Modello	Meglio per	Operazioni	Prezzo di listino
Nano BananaQuesta pagina gemini-2.5-flash-image	Flussi di lavoro 2.5 esistenti e fotogrammi di partenza neutri, a un'unica tariffa elencata per chiamata.	Testo in immagine · Modifica immagine	$0,019 per chiamata
Nano Banana 2.1 gemini-nano-banana-2.1	Nuovo lavoro con lettering preciso, dieci riferimenti a oggetti e output da 1K a 4K.	Testo in immagine · Modifica immagine	$0,019–$0,039 per chiamata
Nano Banana Pro gemini-3-pro-image	Layout complessi e modifiche di ritratti dove il livello massimo elencato acquista dettaglio fisico.	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-2.5-flash-image-001" \
  -d '{
    "model": "gemini-2.5-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,019per chiamataRisparmia 51%

Altri modelli immagine Google

Nano Banana 2

gemini-3.1-flash-image

Nano Banana 2.1

gemini-nano-banana-2.1

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Domande frequenti

Come chiamo Nano Banana 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?

Nano Banana viene fatturato $0,019 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 è uguale a Nano Banana 2?

No. Nano Banana è il nome commerciale che Google dà alla generazione nativa delle immagini di Gemini, e questo ID, gemini-2.5-flash-image, è il membro più vecchio della famiglia sulla piattaforma. Nano Banana 2 usa gemini-3.1-flash-image e Nano Banana 2.1 usa gemini-nano-banana-2.1, ciascuno un modello separato con il proprio comportamento.

Questo modello può produrre un'immagine 4K?

Il catalogo non elenca passi di dimensione per questo ID, quindi pianificate in base alla dimensione che restituisce invece di una tela che scegliete. Se l'obiettivo è un file 4K, Nano Banana 2 e 2.1 elencano entrambi da 1K a 4K, e Pro aggiunge un proprio livello massimo superiore.

Come viene conteggiata la fatturazione su questo modello?

Un'immagine per chiamata a un'unica tariffa, senza passi di dimensione tra cui scegliere, quindi ripetere lo stesso brief costa lo stesso ogni volta. La tariffa attuale è nella tabella dei prezzi sulla pagina del modello. Un task fallito restituisce il credito riservato, e un link a un asset scaduto può essere aggiornato interrogando di nuovo lo stesso task.

Perché tenere un modello di immagini più vecchio nello stack?

Per continuità e per il materiale di partenza: i prompt già approvati continuano a funzionare, e un fotogramma neutro per un confronto di modifiche non richiede il modello più potente. I nuovi brief con testo fitto, diversi riferimenti o una tela grande appartengono a un ID più recente.

Aggiunge un watermark all'immagine?

Google afferma che le immagini generate includono un watermark SynthID, e questo modello appartiene a quella famiglia. Il marchio è metadato di provenienza più che un logo visibile, e non dice nulla se un'etichetta, un conteggio o un volto è venuto bene.