Fluxos de trabalho do Nano Banana 2.1
Executar o Nano Banana 2.1 pela API de imagem da Google Cloud
Um script local pode fazer uma solicitação direta à Google Cloud. Mantenha autenticação, seleção de modelo, configurações de imagem e tratamento de 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 lista de verificação de revisão para um projeto da 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. Verifique o custo atual em créditos e as opções de exportação antes de gerar. A cobrança direta da Google Cloud API é separada. Planos e créditos

O destaque é um conceito de apresentação gerado por IA, mostrando um resultado final em contexto. Não é uma foto de cliente, uma captura de tela do app nem um teste separado de desempenho do modelo.
Conteúdo revisado:
Analise um exemplo gerado
O exemplo abaixo é uma saída direta do modelo, gerada pelo nosso fluxo documentado. Revise 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 fictícios e de propriedade própria. A inclusão deles não garante identidade exata nem detalhes do produto no resultado.

Prepare seu próprio acesso à Google Cloud
A documentação atual do Google chama a plataforma de Gemini Enterprise Agent Platform; muitos desenvolvedores ainda procuram pelo nome anterior, Vertex AI. A amostra aqui segue @google/genai 1.45.0, a versão instalada no nosso fluxo local de geração, 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 para autenticação e configuração do projeto no seu ambiente.
Envie apenas as configurações suportadas por este endpoint
Para este modelo Cloud, os tamanhos de saída documentados são 1K, 2K e 4K. A página atual do modelo 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 do Cloud Storage têm um limite diferente. Esses são limites específicos do endpoint, não uma promessa de que toda combinação seja um bom briefing criativo.
A documentação da Cloud afirma explicitamente que seed, temperature, topP, topK e logprobs não têm suporte no Nano Banana 2.1. Não copie essas configurações de um exemplo de geração de texto nem descreva um seed como controle de reprodutibilidade para este modelo.
- Mantenha o prompt e um pequeno conjunto relevante de referências 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 seu próprio resultado.
Verifique se uma imagem foi realmente retornada
Inspecione as partes da resposta em busca de dados de imagem inline antes de gravar um arquivo de saída. Uma resposta em texto, um resultado filtrado ou uma resposta sem imagem devem ser tratados como um resultado a ser analisado, 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 o comportamento atual de cobrança 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 uma imagem retornada como candidata que ainda precisa de revisão visual.
Separe as partes variáveis
Estas verificações descrevem o caminho direto da Google Cloud. Elas não concedem acesso à API nem substituem a documentação atual de configuração do Google.
| Parte da solicitação | Use ou verifique | Evite presumir |
|---|---|---|
| Autenticação | Seu próprio projeto e credenciais autorizados da Google Cloud | Que uma assinatura da LlamaGen autentica uma solicitação à Cloud API |
| Modelo e localização | 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 de 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 publicar |
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 no nosso fluxo local de geração; 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 logotipos.
Este briefing é uma receita adaptável, não o registro literal do pedido do resultado exibido. Ele não garante resultados idênticos nem uma primeira geração bem-sucedida. O registro de geração preserva o pedido original.
Experimente o fluxo
- Prepare as credenciais e o projeto fora do arquivo-fonte.
- Execute 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 bem o suficiente ao briefing para ser mantido?
Exemplo direto de SDK da Google Cloud
Esta é uma solicitação direta à 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 ou 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"));Dúvidas 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 do modelo no LlamaGen é uma entrada de produto separada.
Posso definir seed ou temperature?
A documentação atual do modelo Cloud informa que seed, temperature, topP, topK e logprobs não são suportados no Nano Banana 2.1. Consulte a documentação do endpoint específico antes de adicionar parâmetros na requisição.
Uma resposta sem imagem significa que devo tentar de novo imediatamente?
Verifique primeiro a resposta e a orientação atual do provedor. Filtros, limites e falhas transitórias podem gerar resultados diferentes. Este guia não promete que uma nova tentativa vai dar certo nem que será gratuita.
Continue seu fluxo
- Nano Banana 2.1 vs Pro: escolha conforme a tarefa
- Edite uma imagem com Nano Banana 2.1 sem perder o briefing
- Crie uma ficha de referência de personagem que dê para revisar de verdade
- Transforme uma cena curta em um storyboard legível com Nano Banana 2.1
- Coloque um produto em uma cena de lifestyle sem perder seus detalhes
