Nano Banana 2 Lite API

Immagine AI

L'API di Nano Banana 2 Lite genera e modifica immagini 1K su OmniaKey a $0.019 per chiamata.

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 2 Lite genera e modifica immagini 1K su OmniaKey a $0.019 per chiamata.

Prova Lite per bozze e modifiche semplici. Nano Banana 2 costa uguale a 1K e offre anche 2K e 4K.

Cosa fa

Testo in immagine

gemini-3.1-flash-lite-image

Trasforma un prompt testuale in una nuova immagine.

Modifica immagine

gemini-3.1-flash-lite-image

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

In dettaglio

Nano Banana 2 Lite è il modello image piccolo di Gemini di Google su OmniaKey con ID modello gemini-3.1-flash-lite-image, contrassegnato per text-to-image e modifica immagine. È l'unico id di questa famiglia la cui voce in catalogo non riporta una matrice di dimensioni: una sola tariffa, una sola dimensione di output pari a 1K, e la pagina del modello di Google esclude esplicitamente 2K e 4K. A 1K si colloca sullo stesso livello di listino di Nano Banana 2, quindi la scelta tra i due riguarda l'intervallo di dimensioni e la profondità della modifica, non uno sconto.

Google presenta Lite come il membro più leggero della famiglia e dichiara che non è ottimizzato per più immagini di riferimento né per modifiche sequenziali su più turni. Va preso alla lettera: un cambio colore, una modifica dello sfondo o un lotto di miniature sono adatti, mentre una catena di revisioni sensibili al brand non lo è. L'id è anche facile da digitare male, perché gemini-3.1-flash-lite senza il suffisso -image è un modello testuale e non questo.

Il comportamento della piattaforma merita una riga a sé. L'etichetta 1K indica una classe di output, non un formato quadrato, quindi inviare aspect_ratio e image_size insieme e fidarsi delle dimensioni consegnate; il limite del corpo di 1 MiB vale per le modifiche, quindi un file da fotocamera va prima ridotto; e riutilizzare un Idempotency-Key con un corpo modificato restituisce 409, evenienza che un ciclo di retry deve gestire.

Miniature e bozze a griglia

Alimentare pagine di categoria e viste elenco con Lite: una dimensione fissa, una tariffa unica e dettaglio sufficiente per una card letta a poche centinaia di pixel. Generare l'intera griglia, poi rigenerare solo i fotogrammi che un cliente apre davvero su un modello con tela più ampia.

Modifiche in un solo passaggio

Un cambio colore o una modifica dello sfondo su un singolo fotogramma di prodotto rientra nel suo ambito, e l'avvertenza di Google sulle modifiche sequenziali ne segna il limite. Fare la modifica in un'unica attività, mantenere la sorgente sotto il limite del corpo di 1 MiB e confrontare l'etichetta e la sagoma con l'originale.

Mettere a punto un prompt a basso costo

Usare Lite per fissare la formulazione prima di una generazione più ampia: quattro varianti a 1K bastano per capire quale formulazione regge, e quella formulazione passa poi a Nano Banana 2.1 a 2K o 4K. Le decisioni di composizione si trasferiscono anche se i pixel no, quindi conservare il testo del prompt accanto al file finale.

Limiti da considerare

Niente 2K o 4K: la pagina di Google per questo id esclude entrambi, quindi un deliverable grande va generato altrove invece di essere ingrandito da un fotogramma 1K.
Google dichiara che il modello non è ottimizzato per più immagini di riferimento o per modifiche sequenziali su più turni, quindi una lunga catena di revisioni di brand va su un modello completo.
L'id dista una parola da un modello testuale: gemini-3.1-flash-lite senza il suffisso -image risponde come testo, quindi un corpo di attività con l'id sbagliato fallisce in modo confuso.
Una tariffa, una dimensione e un'immagine per chiamata: una tela più grande non è disponibile qui, il che rende il volume l'unica leva su un lavoro grande.

Confronta modelli vicini

Modello	Meglio per	Operazioni	Prezzo di listino
Nano Banana 2 LiteQuesta pagina gemini-3.1-flash-lite-image	Miniature, bozze di prompt e modifiche in un solo passaggio in cui un fotogramma 1K è l'intero deliverable.	Testo in immagine · Modifica immagine	$0,019 per chiamata
Nano Banana 2 gemini-3.1-flash-image	Lo stesso livello 1K con 2K e 4K sopra, più un'opzione 512 che questo modello non elenca.	Testo in immagine · Modifica immagine	$0,019–$0,039 per chiamata
Nano Banana 2.1 gemini-nano-banana-2.1	Modifiche ricche di riferimenti e output 4K, con un livello di ragionamento che parte più alto per impostazione predefinita.	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.1-flash-lite-image-001" \
  -d '{
    "model": "gemini-3.1-flash-lite-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 43%

Altri modelli immagine Google

Nano Banana 2

gemini-3.1-flash-image

Nano Banana 2.1

gemini-nano-banana-2.1

Nano Banana

gemini-2.5-flash-image

Domande frequenti

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

Nano Banana 2 Lite 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.

Lite costa meno di Nano Banana 2?

Lite viene fatturato per chiamata alla tariffa indicata nella tabella dei prezzi della pagina del modello, e così Nano Banana 2; a 1K i due condividono un importo, quindi ciò che li distingue è l'intervallo. Lite offre una sola dimensione mentre Nano Banana 2 aggiunge 2K, 4K e un'opzione 512. Un'attività non riuscita restituisce il credito riservato, quindi una miniatura persa non costa nulla.

Per che tipo di modifica è adatto Lite?

Modifiche locali semplici: un cambio colore, una sostituzione dello sfondo, un oggetto rimosso. La guida di Google indica che il modello non è ottimizzato per più riferimenti o per una catena di modifiche sequenziali, quindi limitare ogni attività a una singola modifica e considerare un quarto giro come segnale per passare a un modello superiore.

Quali parametri accetta una richiesta?

aspect_ratio e image_size, la coppia Gemini, anziché i campi size e quality usati da GPT Image. Inviare image_size come 1K, mantenere l'intero corpo sotto 1 MiB quando si invia una modifica e generare un nuovo Idempotency-Key ogni volta che il corpo cambia.

Perché la mia attività ha restituito 409?

Perché l'Idempotency-Key è stato riutilizzato con un corpo diverso. Riutilizzare una chiave solo per ripetere una richiesta identica; dopo aver modificato il prompt, le proporzioni o la dimensione, generarne una nuova e leggere il 409 come segnale per correggere la chiave, non per riprovare alla cieca.

Posso ingrandire un fotogramma Lite a 4K?

Solo come passaggio di elaborazione separato, e il risultato non porterà dettaglio che il modello non ha mai disegnato. Se il deliverable è 2K o 4K, generarlo su Nano Banana 2 o 2.1; ingrandire un file 1K è un ripiego per un'anteprima, non un sostituto di un rendering nativo.