Logo da LlamaGen
Assine agora

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.

Crie com o Nano Banana 2.1

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

Um visual final gerado por IA, apresentado em um contexto criativo do dia a dia.
Conceito de apresentação com IA: um visual final em uso. Esta cena é separada da saída direta do modelo abaixo.

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.

Recursos editoriais da LlamaGen

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.

Saída direta de geração de imagem do Nano Banana 2.1 para o fluxo descrito nesta página.
Uma saída direta do Nano Banana 2.1 a partir do fluxo documentado. Analise a imagem com base nas verificações descritas neste guia.

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çãoUse ou verifiqueEvite presumir
AutenticaçãoSeu próprio projeto e credenciais autorizados da Google CloudQue uma assinatura da LlamaGen autentica uma solicitação à Cloud API
Modelo e localizaçãogemini-nano-banana-2.1 em globalQue um alias de modelo parecido seleciona o mesmo modelo
Configurações de imagemProporção suportada, tamanho de saída e formato de referênciaQue seed ou parâmetros de amostragem de modelos de texto são suportados
RespostaBytes reais da imagem, tipo MIME e um resultado revisávelQue 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

  1. Prepare as credenciais e o projeto fora do arquivo-fonte.
  2. Execute uma solicitação pequena com configurações de imagem suportadas.
  3. 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.