Como Acessar a API Nano Banana Pro?

O Google acaba de lançar o Nano Banana Pro, o codinome oficial para o Gemini 3 Pro Image, um modelo multimodal de ponta que se destaca na geração de texto para imagem, edição de imagem e controle avançado de composição. Desenvolvedores agora acessam esta poderosa ferramenta programaticamente via API Gemini. Pequenos detalhes de configuração geralmente determinam se sua integração terá sucesso ou falhará rapidamente.

💡

Antes de continuar, baixe o Apidog gratuitamente — ele simplifica o teste dos endpoints da API Nano Banana Pro, valida payloads JSON e simula respostas sem escrever código extra. O Apidog lida com a autenticação da API Gemini sem problemas, para que você possa se concentrar em elaborar prompts em vez de depurar cabeçalhos.

botão

Este guia o conduzirá por cada etapa para acessar e usar a API Nano Banana Pro de forma eficaz.

O que é o Nano Banana Pro e por que usar sua API?

O Google DeepMind construiu o Nano Banana Pro sobre a base do Gemini 3 Pro. Ele entrega saídas de imagem com qualidade de estúdio que modelos anteriores não conseguiam igualar. Primeiro, ele renderiza texto dentro de imagens com precisão excepcional — pense em logotipos legíveis, placas multilíngues ou caligrafia estilizada que se alinha perfeitamente com a cena. Em seguida, ele suporta até 14 imagens de entrada para mistura, mantendo a consistência em até cinco assuntos. Além disso, os desenvolvedores controlam ângulos de câmera, iluminação, profundidade de campo, gradação de cores e até mesmo resolução de até 4K.

Prompt: Crie um infográfico sobre esta planta focando em informações interessantes

Além disso, o modelo baseia as gerações em dados de busca do Google em tempo real quando você habilita o recurso. Isso garante a precisão factual para diagramas, infográficos ou mockups de produtos. Cada saída carrega a marca d'água SynthID para rastreamento de proveniência.

Você acessa o Nano Banana Pro através da API Gemini padrão, mas seleciona o identificador de modelo específico (gemini-3-pro-image-preview ou seu sucessor estável). Esta abordagem mantém seu código compatível com outras variantes do Gemini, ao mesmo tempo em que desbloqueia capacidades de imagem de nível profissional.

Passo a Passo: Obtenha Sua Chave da API Gemini

Siga estas ações para obter credenciais:

Vá para o Google AI Studio e faça login com sua conta Google.

Clique no botão "Obter chave da API" na barra lateral esquerda.

Crie uma nova chave ou use uma existente.

Alternativamente, no Vertex AI:

Abra o painel do Vertex AI Studio.
Selecione "IA Generativa" → "Model Garden".
Encontre o Nano Banana Pro (listado como Gemini 3 Pro Image).
Clique em "Habilitar API" e gere as credenciais.

Armazene a chave com segurança em variáveis de ambiente. Nunca a codifique diretamente em arquivos-fonte.

Chame a API Nano Banana Pro do Google AI Studio (Início Rápido)

Você geralmente começa no Google AI Studio para experimentação rápida. Primeiro, visite ai.studio/banana-pro. Selecione "Nano Banana Pro" no menu suspenso de modelos.

Em seguida, mude para a guia "API" para ver exemplos de curl preenchidos automaticamente com sua chave.

Aqui está uma requisição curl básica:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
      }]
    }],
    "generationConfig": {
      "responseModal": "IMAGE"
    }
  }'

Este endpoint permanece o mesmo que o de outros modelos Gemini — apenas o nome do modelo muda.

Use o SDK Oficial Python para Nano Banana Pro

A maioria dos desenvolvedores prefere a biblioteca cliente Python porque ela lida com retentativas, streaming e tipos MIME automaticamente. Instale-a primeiro:

pip install -U google-generativeai

Configure a biblioteca e gere uma imagem:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel('models/gemini-3-pro-image-preview')

response = model.generate_content(
    "A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
    generation_config=genai.types.GenerationConfig(
        response_mime_type="image/png"
    )
)

response.candidates[0].content.parts[0].inline_data.data  # base64 image

Salve a saída assim:

with open("output.png", "wb") as f:
    f.write(response.candidates[0].content.parts[0].inline_data.data)

O SDK abstrai os detalhes de baixo nível, para que você possa se concentrar na engenharia de prompts.

Gerencie Edição de Imagens e Entradas Multi-Imagens

O Nano Banana Pro se destaca em tarefas de edição. Faça upload de imagens como parte do prompt. Por exemplo:

import PIL.Image

img = PIL.Image.open("reference.jpg")

response = model.generate_content(
    [img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)

Você combina várias imagens e texto de forma contínua. O modelo mantém a consistência do assunto entre as referências.

Recursos Avançados: Fundamentação, Configurações de Segurança e Controles

Habilite a fundamentação de Pesquisa Google para injetar fatos em tempo real:

"systemInstruction": {
  "parts": [{"text": "Use search grounding for factual elements"}]
}

Ajuste as configurações de segurança para bloquear ou permitir categorias:

model = genai.GenerativeModel(
    'models/gemini-3-pro-image-preview',
    safety_settings=[
        {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
    ]
)

Especifique a proporção da imagem e a qualidade:

generation_config=genai.types.GenerationConfig(
    candidate_count=1,
    temperature=0.7,
    extra_params={
        "aspect_ratio": "16:9",
        "quality": "highest"
    }
)

Teste e Depure Chamadas da API Nano Banana Pro com Apidog

Comandos curl manuais funcionam para testes únicos, mas o Apidog transforma seu fluxo de trabalho. Importe a especificação OpenAPI oficial do Gemini para o Apidog, e ele gerará automaticamente todos os endpoints, incluindo as variantes do Nano Banana Pro.

Aqui está como você se beneficia:

Visualize esquemas JSON para requisições generateContent.
Salve ambientes (chaves de dev/staging/prod).
Encadeie requisições e valide respostas.
Simule a API localmente para desenvolver offline.
Gere código cliente em mais de 20 linguagens instantaneamente.

Por exemplo, crie uma nova requisição no Apidog, cole o endpoint do Gemini, adicione sua chave de API como um cabeçalho e envie payloads complexos de várias partes com imagens carregadas em segundos. O Apidog valida os campos obrigatórios antes mesmo de você clicar em "Enviar", prevenindo erros 400 comuns.

Muitas equipes relatam ciclos de iteração 50-70% mais rápidos após a mudança para o Apidog para testes da API Gemini.

Implante o Nano Banana Pro no Vertex AI para Produção

Usuários corporativos escalam com o Vertex AI. Crie um endpoint personalizado:

Vá para Vertex AI → Model Garden.
Implante "Gemini 3 Pro Image (Nano Banana Pro)".
Configure o tipo de máquina e o autoescalonamento.
Chame o endpoint de previsão com o SDK do Vertex.

Este caminho fornece endpoints privados, registro e integração de monitoramento com o Cloud Operations.

Preços, Limites de Taxa e Melhores Práticas

O Nano Banana Pro custa mais que modelos mais leves devido aos seus maiores requisitos de computação. Verifique as últimas taxas na página de preços da API Gemini, pois elas se ajustam durante a prévia.

Implemente o backoff exponencial para retentativas. Armazene em cache prompts comuns quando possível. Além disso, agrupe requisições não relacionadas apenas se seu caso de uso permitir — a geração de imagens ainda não suporta agrupamento verdadeiro.

Sempre inclua prompts claros e estruturados. Consulte o guia oficial de prompts para Nano Banana Pro para maximizar a qualidade.

Solução de Problemas Comuns

Você encontrará erros de "modelo não encontrado" se usar o identificador errado. Confirme que você está usando gemini-3-pro-image-preview durante a fase de prévia paga.

Para falhas de autenticação, regenere sua chave e verifique se não há espaços em branco extras. Se as imagens aparecerem com marca d'água inesperadamente, lembre-se de que apenas certas camadas removem o brilho visível.

Quando as saídas parecerem censuradas, ajuste os limites de segurança explicitamente.

Conclusão

Agora você possui todo o conhecimento para acessar e integrar a API Nano Banana Pro de forma eficaz. Comece com o Google AI Studio para resultados instantâneos, passe para o SDK Python para scripting e utilize o Apidog para otimizar testes e depuração.

A combinação das capacidades do Gemini 3 Pro Image sob a bandeira do Nano Banana Pro abre novas possibilidades para design automatizado, ativos de marketing personalizados e ferramentas de visualização de dados. Implemente estas etapas, experimente com ousadia e veja seus aplicativos produzirem visuais que rivalizam com estúdios profissionais.

Baixe o Apidog hoje e acelere seu desenvolvimento com Nano Banana Pro — a diferença na produtividade se tornará evidente após sua primeira sessão.

botão