Workflow di Nano Banana 2.1
Esegui Nano Banana 2.1 tramite l’API di immagini di Google Cloud
Uno script locale può inviare una richiesta diretta a Google Cloud. Mantieni espliciti autenticazione, selezione del modello, impostazioni immagine e gestione del risultato, così che una risposta immagine fallita non diventi silenziosamente un export riuscito.
Cosa creerai
Una richiesta SDK diretta e una checklist di revisione per un progetto Google Cloud che controlli tu. Questo non è accesso a una LlamaGen API pubblica.
Nano Banana 2.1 richiede un piano LlamaGen a pagamento. Controlla il costo in crediti e le opzioni di esportazione prima di generare. La fatturazione diretta tramite Google Cloud API è separata. Piani e crediti

L’hero è un concept di presentazione generato con l’IA che mostra un risultato finito nel suo contesto. Non è una foto cliente, uno screenshot dell’applicazione né un test separato delle prestazioni del modello.
Contenuto verificato:
Esamina un esempio generato
L’esempio qui sotto è un output diretto del modello dal nostro workflow di generazione documentato. Valuta l’immagine reale, invece di dare per scontato che il modello abbia seguito ogni istruzione.
Immagini di riferimento usate nel workflow di generazione
Si tratta di asset di riferimento di nostra proprietà e fittizi. La loro presenza non garantisce identità esatta o dettagli di prodotto nell’output.

Prepara il tuo accesso a Google Cloud
La documentazione attuale di Google chiama la piattaforma Gemini Enterprise Agent Platform; molti sviluppatori la cercano ancora con il nome precedente, Vertex AI. L’esempio qui segue @google/genai 1.45.0, la versione installata nel nostro workflow di generazione locale, usando vertexai: true. Le versioni più recenti dell’SDK potrebbero rinominare le opzioni; segui la documentazione della versione installata.
Usa un progetto con fatturazione attiva, il servizio richiesto abilitato e credenziali autorizzate per la richiesta. Conserva i file dell’account di servizio e i token di accesso fuori dal codice sorgente, dai contenuti della pagina e dai prompt immagine. I costi della Cloud API sono separati da qualsiasi piano LlamaGen.
- Usa l’ID esatto del modello gemini-nano-banana-2.1.
- Usa la località globale documentata per questo modello.
- Segui le istruzioni di Google per autenticazione e configurazione del progetto nel tuo ambiente.
Invia le impostazioni supportate da questo endpoint
Per questo modello Cloud, le dimensioni di output documentate sono 1K, 2K e 4K. La pagina attuale del modello Cloud indica un massimo di 14 immagini di input per prompt e un limite di 7 MB per file per i dati immagine inline; gli input da Cloud Storage hanno un limite diverso. Si tratta di limiti specifici dell’endpoint, non della garanzia che ogni combinazione sia un buon brief creativo.
La documentazione Cloud afferma esplicitamente che seed, temperature, topP, topK e logprobs non sono supportati per Nano Banana 2.1. Non copiare queste impostazioni da un esempio di text generation e non descrivere un seed come controllo di riproducibilità per questo modello.
- Mantieni il prompt e un piccolo set di reference pertinenti facili da controllare.
- Usa il tipo MIME che corrisponde ai byte reali dell’input.
- Registra modello, impostazioni di output e hash delle reference insieme al tuo risultato.
Verifica che sia stata davvero restituita un’immagine
Controlla le parti della risposta per i dati immagine inline prima di scrivere un file di output. Una risposta testuale, un risultato filtrato o una risposta senza immagine vanno trattati come esiti da esaminare, non come una generazione completata.
Non riprovare alla cieca. Salva i metadati non sensibili della richiesta e lo stato della risposta, verifica i limiti documentati e analizza il motivo restituito. Prima di riprovare dopo un errore ambiguo, verifica le attuali modalità di fatturazione del tuo fornitore.
- Non registrare credenziali né immagini di input private complete.
- Mantieni il tipo MIME dell’immagine restituita quando scegli l’estensione del file.
- Tratta l’immagine restituita come una candidata che richiede ancora revisione visiva.
Separa gli elementi in gioco
Questi controlli descrivono il percorso diretto di Google Cloud. Non concedono accesso all’API né sostituiscono la documentazione aggiornata di configurazione di Google.
| Parte della richiesta | Usa o verifica | Evita di dare per scontato |
|---|---|---|
| Autenticazione | Il tuo progetto Google Cloud autorizzato e le tue credenziali | Che un abbonamento LlamaGen autentichi una richiesta alla Cloud API |
| Modello e località | gemini-nano-banana-2.1 in global | Che un alias di modello simile selezioni lo stesso modello |
| Impostazioni immagine | Rapporto d’aspetto supportato, dimensione di output e formato della reference | Che seed o i parametri di sampling dei modelli testuali siano supportati |
| Risposta | Byte reali dell’immagine, tipo MIME e un risultato verificabile | Che ogni risposta HTTP riuscita includa un’immagine pubblicabile |
Un workflow pratico
Da una piccola richiesta a un file da revisionare
Inizia con una singola richiesta semplice per un’immagine originale. L’esempio qui sotto segue la struttura SDK diretta usata dal nostro workflow di generazione locale; sostituisci l’ambiente del progetto e autentica tramite la tua configurazione approvata.
Un prompt di partenza da adattare
Crea un corriere illustrato originale che porta una lanterna in una strada sotto la pioggia. Usa una silhouette chiara e una scena leggibile. Non aggiungere testo né loghi.
Questo brief è una ricetta adattabile, non il log letterale della richiesta per il risultato mostrato. Non promette risultati identici né una prima generazione riuscita. Il record di generazione conserva la richiesta originale.
Prova il workflow
- Prepara credenziali e progetto fuori dal file sorgente.
- Esegui una richiesta piccola con impostazioni immagine supportate.
- Controlla le parti immagine restituite, salva con il tipo MIME corretto e rivedi il file reale.
Cosa controllare
- È stata davvero restituita una parte immagine?
- Il file salvato si apre correttamente?
- Il visual corrisponde abbastanza al brief da essere tenuto?
Esempio diretto con Google Cloud SDK
Questa è una richiesta diretta a Google Cloud usando il tuo progetto e le tue credenziali. Non è un endpoint pubblico della LlamaGen API. Non incollare chiavi private in un prompt o in una pagina pubblica.
import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";
// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
vertexai: true,
project: process.env.GOOGLE_CLOUD_PROJECT,
location: "global",
httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
model: "gemini-nano-banana-2.1",
contents: [{ role: "user", parts: [{
text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
}] }],
config: {
responseModalities: ["IMAGE"],
candidateCount: 1,
imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
thinkingConfig: { thinkingLevel: "HIGH" },
},
});
const image = response.candidates?.[0]?.content?.parts?.find(
(part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));Domande prima di iniziare
Questa è una LlamaGen API pubblica?
No. Il codice usa l’SDK di Google per chiamare Google Cloud direttamente con il tuo progetto e le tue credenziali. La pagina del modello LlamaGen è una voce di prodotto separata.
Posso impostare seed o temperature?
La documentazione attuale del modello Cloud indica che seed, temperature, topP, topK e logprobs non sono supportati per Nano Banana 2.1. Controlla la documentazione del singolo endpoint prima di aggiungere parametri alla richiesta.
Se la risposta non include un’immagine, devo riprovare subito?
Controlla prima la risposta e le indicazioni aggiornate del provider. Filtri, limiti e errori temporanei possono portare a risultati diversi. Questa guida non promette che un nuovo tentativo abbia successo o sia gratuito.
Continua il workflow
- Nano Banana 2.1 vs Pro: scegli in base al compito da svolgere
- Modifica un’immagine con Nano Banana 2.1 senza perdere il brief
- Crea una scheda di riferimento del personaggio davvero controllabile
- Trasforma una breve scena in uno storyboard leggibile con Nano Banana 2.1
- Inserisci un prodotto in una scena lifestyle senza perderne i dettagli
