Logo di LlamaGen
Abbonati ora

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.

Crea con Nano Banana 2.1

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

Un visual finito generato con IA, presentato in un contesto creativo quotidiano.
Concept di presentazione IA: un visual finito mostrato in uso. Questa scena è separata dall’output diretto del modello qui sotto.

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.

Risorse editoriali di LlamaGen

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.

Output diretto di generazione immagini di Nano Banana 2.1 per il workflow descritto in questa pagina.
Un output diretto di Nano Banana 2.1 dal workflow documentato. Controlla l’immagine in base alle verifiche descritte in questa guida.

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 richiestaUsa o verificaEvita di dare per scontato
AutenticazioneIl tuo progetto Google Cloud autorizzato e le tue credenzialiChe un abbonamento LlamaGen autentichi una richiesta alla Cloud API
Modello e localitàgemini-nano-banana-2.1 in globalChe un alias di modello simile selezioni lo stesso modello
Impostazioni immagineRapporto d’aspetto supportato, dimensione di output e formato della referenceChe seed o i parametri di sampling dei modelli testuali siano supportati
RispostaByte reali dell’immagine, tipo MIME e un risultato verificabileChe 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

  1. Prepara credenziali e progetto fuori dal file sorgente.
  2. Esegui una richiesta piccola con impostazioni immagine supportate.
  3. 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.