Google · API media

Nano Banana 2 API

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.

Ottieni la tua chiave API Leggi i documenti

ID modello disponibili: gemini-3.1-flash-imagegemini-3.1-flash-image-previewEntrambi gli ID chiamano lo stesso prodotto con le stesse capacità e lo stesso prezzo. Puoi usare l'uno o l'altro.
Fornitore: Google
Modalità: Immagine AI
Per chiamata riuscita: $0,068
Ultimo verificato: 2026-09-11

Quando usarlo

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.

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.

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

Altri modelli immagine Google

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-image

Nano Banana Pro

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