Fluxos de trabalho do Nano Banana 2.1
Executar o Nano Banana 2.1 pela API de imagens do Google Cloud
Um script local pode fazer uma solicitação direta ao Google Cloud. Mantenha a autenticação, a seleção do modelo, as configurações de imagem e o tratamento do resultado explícitos, para que uma resposta de imagem com falha não vire silenciosamente uma exportação bem-sucedida.
O que você vai criar
Uma solicitação direta via SDK e uma checklist de revisão para um projeto do Google Cloud que você controla. Isso não é acesso a uma API pública da LlamaGen.
O Nano Banana 2.1 exige um plano pago da LlamaGen. Confira o custo atual em créditos e as opções de exportação antes de gerar. A cobrança direta da API do Google Cloud é separada. Planos e créditos

O destaque é um conceito de apresentação gerado por IA, mostrando um resultado final em contexto. Não se trata de uma foto de cliente, captura de tela de aplicativo ou um teste separado de desempenho do modelo.
Conteúdo revisado:
Analisar um exemplo gerado
O exemplo abaixo é uma saída direta do modelo, gerada pelo nosso fluxo de trabalho documentado. Analise a imagem real em vez de assumir que o modelo seguiu todas as instruções.
Imagens de referência usadas no fluxo de geração
São ativos de referência próprios e fictícios. A inclusão deles não garante identidade exata nem detalhe perfeito do produto no resultado.

Prepare seu próprio acesso ao Google Cloud
A documentação atual do Google chama a plataforma de Gemini Enterprise Agent Platform; muitos desenvolvedores ainda a procuram pelo nome anterior, Vertex AI. O exemplo aqui segue @google/genai 1.45.0, a versão instalada no nosso fluxo de geração local, usando vertexai: true. Versões mais novas do SDK podem renomear opções; siga a documentação da versão instalada.
Use um projeto com cobrança ativa, o serviço necessário habilitado e credenciais autorizadas para a solicitação. Mantenha arquivos de service account e tokens de acesso fora do código-fonte, do conteúdo da página e dos prompts de imagem. As cobranças da Cloud API são separadas de qualquer plano da LlamaGen.
- Use o ID exato do modelo gemini-nano-banana-2.1.
- Use a localização global documentada para este modelo.
- Siga as instruções do Google de autenticação e configuração do projeto para o seu ambiente.
Envie apenas as configurações suportadas por este endpoint
Para este modelo da Cloud, os tamanhos de saída documentados são 1K, 2K e 4K. A página atual do modelo na Cloud informa um máximo de 14 imagens de entrada por prompt e um limite de 7 MB por arquivo para dados de imagem inline; entradas via Cloud Storage têm outro limite. São limites específicos do endpoint, não uma promessa de que qualquer combinação forme um bom briefing criativo.
A documentação da Cloud afirma explicitamente que seed, temperature, topP, topK e logprobs não são suportados no Nano Banana 2.1. Não copie essas configurações de um exemplo de geração de texto nem descreva seed como um controle de reprodutibilidade para este modelo.
- Mantenha o prompt e um pequeno conjunto de referências relevantes fáceis de inspecionar.
- Use o tipo MIME que corresponda aos bytes reais de entrada.
- Registre o modelo, as configurações de saída e os hashes das referências junto com o seu resultado.
Verifique se houve retorno de uma imagem real
Inspecione as partes da resposta em busca de dados de imagem inline antes de gravar um arquivo de saída. Uma resposta de texto, um resultado filtrado ou uma resposta sem imagem deve ser tratado como algo a ser verificado, não como uma geração concluída.
Não tente novamente às cegas. Salve metadados não sensíveis da solicitação e o status da resposta, verifique os limites documentados e investigue o motivo retornado. Se você repetir uma falha ambígua, entenda primeiro como está a cobrança atual do seu provedor.
- Não registre credenciais nem imagens privadas completas de entrada.
- Preserve o tipo MIME da imagem retornada ao escolher a extensão do arquivo.
- Trate a imagem retornada como uma candidata que ainda precisa de revisão visual.
Separe os elementos variáveis
Estas verificações descrevem o caminho direto do Google Cloud. Elas não concedem acesso à API nem substituem a documentação atual de configuração do Google.
| Parte da solicitação | Usar ou verificar | Evite assumir |
|---|---|---|
| Autenticação | Seu próprio projeto autorizado do Google Cloud e suas credenciais | Que uma assinatura da LlamaGen autentica uma solicitação da Cloud API |
| Modelo e local | gemini-nano-banana-2.1 em global | Que um alias de modelo parecido seleciona o mesmo modelo |
| Configurações de imagem | Proporção suportada, tamanho de saída e formato da referência | Que seed ou parâmetros de amostragem de modelos de texto são suportados |
| Resposta | Bytes reais da imagem, tipo MIME e um resultado revisável | Que toda resposta HTTP bem-sucedida inclui uma imagem pronta para publicação |
Um fluxo de trabalho prático
De uma pequena solicitação a um arquivo revisável
Comece com uma solicitação simples de imagem original. O exemplo abaixo segue a estrutura direta de SDK usada pelo nosso fluxo de geração local; substitua o ambiente do projeto e autentique-se por meio da sua própria configuração aprovada.
Um prompt inicial para adaptar
Crie um entregador ilustrado original carregando uma lanterna em uma rua chuvosa. Use uma silhueta clara e uma cena legível. Não adicione texto nem logos.
Este briefing é uma receita adaptável, não o registro literal do pedido para o resultado exibido. Ele não promete resultados idênticos nem uma primeira geração bem-sucedida. O registro de geração preserva o pedido original.
Testar o fluxo
- Prepare as credenciais e o seu projeto fora do arquivo de código-fonte.
- Faça uma solicitação pequena com configurações de imagem suportadas.
- Inspecione as partes da imagem retornada, salve com o tipo MIME correto e revise o arquivo real.
O que verificar
- Uma parte de imagem realmente foi retornada?
- O arquivo salvo abre corretamente?
- O visual corresponde ao briefing o suficiente para ser aprovado?
Exemplo direto de SDK do Google Cloud
Esta é uma solicitação direta ao Google Cloud usando seu próprio projeto e credenciais. Não é um endpoint público da API da LlamaGen. Não cole chaves privadas em um prompt nem em uma página pública.
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"));Perguntas antes de começar
Esta é uma API pública da LlamaGen?
Não. O código usa o SDK do Google para chamar o Google Cloud diretamente com seu próprio projeto e credenciais. A página de modelo da LlamaGen é uma entrada separada do produto.
Posso definir seed ou temperature?
A documentação atual do modelo Cloud informa que seed, temperature, topP, topK e logprobs não têm suporte no Nano Banana 2.1. Confira a documentação específica do endpoint antes de adicionar parâmetros à requisição.
Uma resposta sem imagem significa que devo tentar de novo imediatamente?
Analise primeiro a resposta e as orientações atuais do provedor. Filtros, limites e falhas transitórias podem levar a resultados diferentes. Este guia não garante que uma nova tentativa vai funcionar nem que será gratuita.
Continuar seu fluxo
- Nano Banana 2.1 vs Pro: escolha de acordo com a tarefa
- Edite uma imagem com Nano Banana 2.1 sem perder o briefing
- Crie uma ficha de referência de personagem que você realmente consiga revisar
- Transforme uma cena curta em um storyboard legível no Nano Banana 2.1
- Coloque um produto em uma cena lifestyle sem perder seus detalhes
