Nano Banana

API di editing immagini Nano Banana su E2X: tre reference e una data di spegnimento

La capability di editing di Nano Banana è il gemini-2.5-flash-image di Google che riceve immagini sorgente invece di una tela bianca. La serviamo su google/nano-banana/edit-image a $0.0312 per immagine modificata — il 20% sotto fal.ai — e accetta un massimo di tre reference image con output a 1K. Prima di scrivere una riga di codice di integrazione, una cosa viene prima di tutte: Google ritira questo modello il 2 ottobre 2026.

Trentasette giorni, contati dal giorno in cui questa pagina è stata pubblicata. Le pipeline esistenti continuano a girare fino ad allora e il nostro prezzo non si muove. Ma venderLe un editor con un conto alla rovescia di cinque settimane significherebbe soltanto comprarLe una riscrittura a ottobre.

Il nostro prezzo rispetto al mercato, verificato il 26 agosto 2026:

I prezzi e le condizioni dei prodotti possono cambiare nel tempo. Verifichi i prezzi aggiornati di ciascun provider prima di prendere una decisione d'acquisto. Il prezzo Google Batch o Flex non è direttamente equivalente a una request API on-demand standard, perché le condizioni di pianificazione, disponibilità ed elaborazione sono diverse; è quindi escluso da questo confronto. Si tratta di un confronto circoscritto a uno scenario d'uso specifico, non dell'affermazione che E2X sia l'opzione più economica al mondo in ogni configurazione.

Perché apriamo con un avviso di ritiro

Perché lo fa Google. Quando l'azienda ha annunciato Nano Banana 2 Lite, ha scritto:

"È il sostituto che raccomandiamo agli sviluppatori che oggi usano la nostra prima versione di Nano Banana (gemini-2.5-flash-image): potete sostituirlo subito per averne benefici immediati."

La documentazione dei modelli di Google va oltre, definendo questo il pioniere legacy della serie e raccomandando con forza ai clienti di migrare. È raro che un vendor spinga i clienti fuori da un prodotto che sta ancora fatturando. Quando lo fa, gli si può credere.

Nessuna immagine sorgente da cui partire? Allora Le serve Nano Banana text-to-image — stesso modello, stesso prezzo, solo prompt.

Il tetto delle tre reference

È il numero che separa l'editor legacy da tutto ciò che nella famiglia è più recente. L'indicazione di Google è esplicita: per ottenere i risultati migliori con Gemini 2.5 Flash Image, includa un massimo di tre immagini in un input.

Tre bastano per molto lavoro reale. Un soggetto, uno sfondo, una reference di colore — quel composite ci sta. Quello che non ci sta è il brief in stile pubblicitario in cui un personaggio, un prodotto, gli oggetti di scena e una palette di brand finiscono tutti in una sola chiamata. Nano Banana Pro accetta quattordici reference esattamente per quel compito. Qui invece si concatenano più chiamate, pagando ogni passaggio, e ogni passaggio si allontana di più dall'originale.

Altri due limiti da tenere davanti agli occhi prima di progettare intorno a questo modello:

• L'output si ferma a 1K. Su questa generazione non esiste alcun tier superiore, qualunque cosa suggerisca un campo dello schema.
• Non gli chieda di correggere il testo in un'immagine. Il rendering del testo dentro l'immagine è un punto di forza di Gemini 3, non di questo modello. Sostituire un prezzo su un'etichetta o tradurre un cartello è il caso di fallimento più frequente.
• Dieci aspect ratio sono disponibili, da 21:9 fino a 4:5, e l'immagine sorgente non La vincola al proprio.
• Il budget di token è 65.536 in ingresso e 32.768 in uscita, con knowledge cutoff a giugno 2025 — quindi per qualsiasi cosa recente è più sicura una reference che una descrizione.

Request API: editing a partire da immagini sorgente

Due campi sono obbligatori: prompt e image_urls. Tenga la Sua API key lato server.

curl -X POST https://api.e2x.ai/v1/jobs/submit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana/edit-image",
    "input": {
      "prompt": "Cambia la parete dietro la sedia da bianca a verde oliva scuro. Lascia la sedia, il pavimento e le ombre esattamente come sono.",
      "image_urls": [
        "https://example.com/interior.jpg"
      ],
      "aspect_ratio": "4:5"
    }
  }'

L'invio restituisce un job ID. Faccia polling finché non si risolve:

const headers = {
  Authorization: `Bearer ${process.env.E2X_API_KEY}`,
  "Content-Type": "application/json",
};

const submitted = await fetch("https://api.e2x.ai/v1/jobs/submit", {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "google/nano-banana/edit-image",
    input: {
      prompt: "L'immagine 1 è la bicicletta, l'immagine 2 è il luogo. Metti la bicicletta sul selciato dell'immagine 2, rispettandone la luce coperta.",
      image_urls: [
        "https://example.com/bike.jpg",
        "https://example.com/street.jpg",
      ],
      aspect_ratio: "1:1",
    },
  }),
}).then((r) => r.json());

const jobId = submitted.data.jobId;

while (true) {
  const job = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, { headers })
    .then((r) => r.json());

  if (job.data.status === "completed") {
    console.log(job.data.outputs[0].url);
    break;
  }
  if (job.data.status === "failed") {
    throw new Error(job.data.error?.message || "Edit failed");
  }
  await new Promise((r) => setTimeout(r, 2000));
}

Gli status vanno da pending → processing → completed, con failed e cancelled come stati terminali. Passi un webhookUrl per evitare del tutto il polling. Il nostro default di aspect_ratio è 9:16 — lo imposti, altrimenti la Sua sorgente orizzontale torna indietro verticale. Lo schema aggiornato sta nella specifica leggibile dalle macchine di questo modello.

Il passaggio che raccomandiamo, e perché non Le costa nulla

Tutti i modelli di editing che facciamo girare, con prezzo per immagine:

Di solito una migrazione è uno scambio: modello più recente, conto più alto, approvazione necessaria. Non questa volta. Nano Banana 2 Lite costa il 24% in meno dell'editor legacy ed è una generazione più avanti, il che significa che la conversazione con la finanza e quella con l'engineering finiscono allo stesso modo. Con mille modifiche al mese si tiene in tasca circa $9 e allo stesso tempo ottiene output migliori.

Preferiamo dirlo apertamente piuttosto che tenerLa su uno slug che sappiamo essere in scadenza. Se le Sue modifiche riguardano testi leggibili — scatti di packaging, menu board, creatività localizzate — salga sopra Lite fino a Nano Banana Pro, dove Google ha messo il rendering multilingue del testo. Il resto si sfoglia nella categoria image-to-image o nel nostro catalogo modelli.

Abitudini di editing che si portano dietro sul modello sostitutivo

Una buona notizia sulla migrazione: la disciplina di prompting si trasferisce intatta, quindi tutto quello che impara questa settimana non va perso.

Nomini il cambiamento, poi nomini le costanti. "Ricolora il divano in lino ruggine; lascia intatti i cuscini, il disegno del tappeto e la luce dalla finestra" tiene molto meglio di una descrizione riscritta della scena. L'istinto di descrivere l'intera immagine arriva dal text-to-image, e in una modifica compete con la reference finché il modello rigenera invece di aggiustare.

Quando invia due o tre immagini, dica dentro il prompt che cos'è ciascuna — nient'altro comunica al modello che il secondo allegato era un luogo e non un secondo soggetto. Eviti anche di impilare tre modifiche in una sola chiamata. Le divida, concateni il primo output nel secondo, e spenderà la stessa cifra con molta meno deriva.

Controlli prima del decollo

SynthID è sempre attivo. Google incorpora il proprio watermark impercettibile in ogni output e non esiste alcun parametro, presso nessun provider, per rimuoverlo. Chiarisca questo punto rispetto ai contratti con i clienti prima di costruire.

Lasci resolution su 1k — questo costa soldi. Il nostro schema porta lo stesso campo resolution su tutta la famiglia Nano Banana, quindi questo endpoint accetterà da Lei 2k e 4k senza lamentarsi. I pesi di Google non li onoreranno. gemini-2.5-flash-image produce 1K e nulla al di sopra, perciò una request inviata a 4k viene fatturata con il nostro moltiplicatore ×2 — $0.0624 invece di $0.0312 — e restituisce esattamente la stessa immagine 1K che avrebbe ricevuto a metà prezzo. Preferiamo segnalarlo piuttosto che incassarlo. I tier più recenti hanno invece scale di risoluzione reali: Nano Banana Pro arriva davvero a 4096×4096.

Metta un promemoria in calendario, non un ticket nel backlog. Il 2 ottobre 2026 il modello upstream smette di rispondere, e tutto ciò che è ancora puntato su questo slug — un cron job, un pulsante rivolto ai clienti, un batch notturno — fallisce quel giorno. Cambiare una stringa adesso è meglio che fare debug allora.

Domande che riceviamo sull'editor legacy

Quante reference image accetta Nano Banana edit-image?

Al massimo tre. L'indicazione di Google per gemini-2.5-flash-image è di includere un massimo di tre immagini in un input, e oltre quel numero la qualità peggiora. Per composite più pesanti, Nano Banana Pro gestisce fino a quattordici reference distribuite fra ruoli di personaggio, oggetto e stile.

Cosa succede alla mia integrazione il 2 ottobre 2026?

Le request verso google/nano-banana/edit-image smettono di andare a buon fine, perché Google sta ritirando i pesi sottostanti ovunque, non solo sulla nostra piattaforma. Nessun provider può continuare a servire un modello che il vendor ha spento. Passi a Nano Banana 2 Lite prima di quella data.

Nano Banana 2 Lite è davvero più economico del modello legacy?

Sì — $0.0238 per modifica contro gli $0.0312 di qui, una differenza del 24%, su pesi più recenti. Google lo inquadra allo stesso modo, citando qualità migliore, generazione più veloce e prezzi più bassi. È il raro upgrade senza alcun compromesso di costo.

Quanto costa l'editing di immagini Nano Banana su E2X?

$0.0312 per immagine modificata alla risoluzione di default 1k, il 20% sotto i $0.039 che abbiamo rilevato su fal.ai, sull'API Gemini di Google e su OpenRouter il 26 agosto 2026. Allegare una reference o tre costa uguale, ma inviare resolution: "4k" applica un moltiplicatore ×2 per un output che questo modello non è in grado di produrre — lo lasci su 1k. Ricontrolli la pagina del modello aggiornata prima di impegnare un budget.

Può modificare o tradurre il testo dentro un'immagine?

Non in modo affidabile. Il rendering avanzato del testo appartiene alla generazione Gemini 3 e questo modello la precede, quindi le parole modificate tornano spesso distorte o reinterpretate. Nano Banana Pro è il tier costruito per testo in-immagine leggibile e multilingue.

L'immagine modificata mantiene un watermark?

Sì. SynthID è incorporato in ogni output di questo modello, esattamente come nella capability text-to-image. È il marcatore di provenienza di Google e nessun provider offre un modo per disattivarlo.

Qual è la differenza fra le capability edit e text-to-image?

Stessi pesi, stesso prezzo di $0.0312, input diverso. Edit-image richiede image_urls accanto al prompt e modifica ciò che gli fornisce; text-to-image prende solo un prompt e costruisce dal nulla. Scelga in base al fatto che esista già un'immagine sorgente.