Google · API media

Nano Banana Pro API

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.

Ottieni la tua chiave API Leggi i documenti

ID modello disponibili: gemini-3-pro-imagegemini-3-pro-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,09
Ultimo verificato: 2026-09-11

Quando usarlo

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.

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.

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

Altri modelli immagine Google

Nano Banana 2

gemini-3.1-flash-image

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-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,09 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.