Nano Banana Pro API

Immagine AI

L'API di Nano Banana Pro è la rotta immagine Gemini 3 Pro più fedele di Google su OmniaKey, pensata per il testo-immagine dettagliato e le modifiche con riferimento che richiedono ragionamento.

Leggi la documentazione Ottieni la tua chiave API

Per chiamata riuscita$0,039–$0,069
OperazioniTesto in immagine
Modifica immagine
IDgemini-3-pro-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 Pro è la rotta immagine Gemini 3 Pro più fedele di Google su OmniaKey, pensata per il testo-immagine dettagliato e le modifiche con riferimento che richiedono ragionamento.

Scegli Nano Banana Pro per composizioni complesse e modifiche che richiedono un modello più forte, e scendi a Nano Banana 2 per la generazione ad alto volume dove conta il costo per chiamata.

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-pro-image

Trasforma un prompt testuale in una nuova immagine.

Modifica immagine

gemini-3-pro-image

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

In dettaglio

Nano Banana Pro è il modello image di Gemini di fascia più alta per fedeltà disponibile su OmniaKey, venduto come gemini-3-pro-image, con gemini-3-pro-image-preview accettato come ID modello equivalente. Copre la generazione da testo e la modifica immagine. Occupa il livello più alto tra gli ID modello image di Gemini presenti qui, e la tabella dei livelli ha una particolarità da conoscere: le voci 1K e 2K hanno lo stesso importo, quindi la dimensione intermedia è il modo meno efficiente per raggiungere il suo dettaglio.

Dove il livello superiore offre qualcosa in più è nel dettaglio fisico. Pro è stato l'unico dei tre modelli a disegnare polvere sospesa in un fascio di luce mantenendo morbidi gli scaffali e nitide le mani, e in una natura morta abbinata ha restituito un JPEG da 545.484 byte con 450 token dichiarati. Spostando una persona in una nuova scena ha mantenuto ogni dettaglio elencato, alla pari con Nano Banana 2. I layout sono il suo lato debole: entrambe le esecuzioni del poster sono tornate come mockup su una parete.

La direzione della luce è la sorpresa ricorrente. Chiesto un flacone di profumo illuminato da destra, Pro ha lasciato lo spazio per il testo più pulito dei tre e poi ha messo la luce a sinistra, quindi specchiare il fotogramma per correggerlo avrebbe specchiato anche la parola incisa. Il resto segue il comportamento della famiglia: un'immagine per chiamata, fatturazione determinata dal livello di output, in cima alla fascia qui.

Texture e luce fotorealistiche

Ceramiche, vetro, polvere e pelle: scegli Pro quando un fotogramma deve sembrare fotografato e non renderizzato. La nostra scena con il ceramista è stata l'unica delle tre in cui la polvere restava sospesa nella luce mentre gli scaffali rimanevano morbidi e le mani nitide. Indica la sorgente di luce e il materiale, poi controlla bordi e riflessi a dimensione piena.

Modifiche che mantengono una persona

Nel nostro test con la stessa persona in una nuova scena Pro ha mantenuto ogni dettaglio elencato ed è stato alla pari con l'altro modello pulito. Invia l'immagine di riferimento del volto come input separato, elenca i segni che devono restare e confronta il risultato con il riferimento prima di procedere, perché una somiglianza convincente non equivale a una somiglianza accurata.

Fotogrammi di prodotto con spazio per il testo

Il suo vantaggio nel lavoro di prodotto è lo spazio per il testo: lo scatto del profumo ha lasciato l'area più pulita per il testo tra i tre eseguiti. Posiziona il soggetto fuori centro nel prompt, indica da quale lato arriva la luce e prevedi di specchiare il fotogramma tu stesso quando il modello lo capovolge.

Note di test

Nel nostro test fotografico con il ceramista, Nano Banana Pro è stato l'unico dei tre modelli a disegnare polvere nella luce insieme a scaffali morbidi e mani nitide.
Leggi il test
Nel nostro test del poster, Nano Banana Pro ha mantenuto esattamente il testo su due righe in entrambe le esecuzioni ma ha restituito il poster come mockup su una parete entrambe le volte.
Leggi il test
Nano Banana Pro ha lasciato lo spazio per il testo più pulito nel nostro scatto di prodotto del profumo ma ha messo la luce a sinistra, all'opposto del prompt.
Leggi il test
Nel nostro caso di natura morta abbinata, lo stesso prompt con Nano Banana Pro ha restituito un JPEG da 545.484 byte e 450 token dichiarati.
Leggi il test
Nei sei test del 16 ottobre 2026, Nano Banana Pro è stato il più lento dei tre modelli Gemini, con una mediana di 33 secondi per immagine.
Leggi il test

Limiti da considerare

La direzione della luce non segue il prompt. Il nostro brief sul profumo chiedeva luce da destra e Pro l'ha messa da sinistra, quindi una correzione specchiata avrebbe capovolto anche la parola incisa.
I poster arrivano come fotografie di un poster: entrambe le esecuzioni sono tornate come mockup su una parete, quindi prevedi un ritaglio o un composito prima che il file vada in stampa.
È il livello più alto tra gli ID modello image di Gemini presenti qui a 1K e 4K, mentre 1K coincide con 2K, quindi una bozza piccola è il modo meno efficiente di usare il modello.
Il budget dei riferimenti è sbilanciato: la guida di Google consente sei immagini di oggetti e cinque immagini di personaggi, contro dieci e quattro su Nano Banana 2.1, quindi le foto di gruppo impongono una scelta.

Confronta modelli vicini

Modello	Meglio per	Operazioni	Prezzo di listino
Nano Banana ProQuesta pagina gemini-3-pro-image	Nature morte sensibili al brand e modifiche di ritratti in cui il dettaglio fisico e i segni preservati decidono la revisione.	Testo in immagine · Modifica immagine	$0,039–$0,069 per chiamata
Nano Banana 2.1 gemini-nano-banana-2.1	Generazione generale e lavoro di layout a un livello inferiore a ogni dimensione, con output poster più pulito.	Testo in immagine · Modifica immagine	$0,019–$0,039 per chiamata
Nano Banana 2 gemini-3.1-flash-image	Generazione ad alto volume in fondo alla fascia, ora deprecato da Google ma ancora attivo.	Testo in immagine · Modifica immagine	$0,019–$0,039 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-pro-image-001" \
  -d '{
    "model": "gemini-3-pro-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,039–$0,069per chiamataRisparmia 71%

image_size

1K: $0,039per chiamata
2K: $0,039per chiamata
4K: $0,069per chiamata

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 Pro 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 Pro?

Nano Banana Pro viene fatturato $0,039–$0,069 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.

Pro o 2.1 per un asset sensibile al brand?

Pro se un dettaglio sbagliato imporrebbe un'altra revisione: è stato l'unico modello nel nostro test a tre a disegnare polvere nella luce con scaffali morbidi e mani nitide, e ha mantenuto ogni dettaglio elencato del volto nel caso della nuova scena. 2.1 è subito dietro e ha vinto l'infografica e lo scatto di prodotto. Prova il brief che usi davvero.

Quale ID modello usa Pro?

gemini-3-pro-image, con gemini-3-pro-image-preview accettato come ID modello equivalente nel catalogo. Tieni quell'ID distinto dalle etichette consumer di Gemini come Pro o Thinking, che indicano modalità nell'app e non modelli API, e riporta l'ID esattamente nel corpo di un task.

Perché il mio poster è la foto di un poster?

Entrambe le nostre esecuzioni del poster sono tornate come mockup appeso a una parete, anche se le due righe di testo erano esatte. Chiedi un file piatto nel prompt e, quando torna un mockup, ritaglialo o componi tu stesso la grafica; il testo resta comunque utilizzabile come livello.

Come viene fatturato Nano Banana Pro?

Un'immagine per chiamata, alla tariffa della tabella dei prezzi nella pagina del modello, che varia in base alla dimensione di output: 1K e 2K condividono un importo e 4K sta sopra, il livello più alto tra gli ID modello image di Gemini presenti qui. Un task fallito restituisce il credito riservato e una richiesta restituisce un'immagine.

Quante immagini di riferimento posso allegare?

Fino a 14 in totale, divise in sei immagini di oggetti e cinque immagini di personaggi nella guida alle immagini di Google, dove Nano Banana 2.1 consente dieci oggetti e quattro personaggi. Una foto di gruppo richiede quindi una decisione su chi riceve un riferimento, non un elenco più lungo.