Google · API media

Nano Banana 2 Lite API

Nano Banana 2 Lite è la rotta immagine Gemini 3.1 più economica di Google su OmniaKey, con generazione rapida da testo e modifica tramite riferimento.

Ottieni la tua chiave API Leggi i documenti

ID modello: gemini-3.1-flash-lite-image
Fornitore: Google
Modalità: Immagine AI
Per chiamata riuscita: $0,039
Ultimo verificato: 2026-09-17

Quando usarlo

Scegli Nano Banana 2 Lite per bozze, grandi volumi e prodotti sensibili ai costi; passa a Nano Banana 2 quando il modello Flash completo vale il piccolo sovrapprezzo.

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.

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,039per chiamata

Altri modelli immagine Google

Nano Banana 2

gemini-3.1-flash-image

Nano Banana

gemini-2.5-flash-image

Nano Banana Pro

gemini-3-pro-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,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.