Tutorial Completo para Desenvolvedores sobre o Nano Banana Pro

@GoogleAIStudio
INGLÊShá 8 meses · 22 de nov. de 2025
728K
3.6K
588
58
5.0K

TL;DR

Um guia abrangente para desenvolvedores aproveitarem o Nano Banana Pro (Gemini 3 Pro Image), apresentando tutoriais sobre search grounding, resolução 4K e mixagem avançada de imagens via Gemini API.

Descubra como os recursos avançados deste modelo de IA de última geração — incluindo raciocínio, fundamentação em pesquisa e saída impressionante em 4K — vão te capacitar a criar aplicações complexas e criativas.

Enquanto o modelo Flash (Nano Banana) trouxe velocidade e acessibilidade, a versão Pro introduz capacidades de "raciocínio", fundamentação em pesquisa e saída em 4K de alta fidelidade. É hora de se jogar de cabeça em tarefas criativas complexas!

Este guia vai te mostrar os recursos avançados do Nano Banana Pro usando a Gemini Developer API.

**Este guia abordará:

**1. Usando o Nano Banana Pro no Google AI Studio

  1. Configuração do projeto
  2. Inicializar o Client
  3. Geração Básica (Os Clássicos)
  4. O Processo de "Raciocínio"
  5. Fundamentação em Pesquisa
  6. Geração em 4K de Alta Resolução
  7. Capacidades Multilíngues
  8. Mixagem Avançada de Imagens
  9. Demonstrações Exclusivas do Pro
  10. Melhores Práticas e Dicas de Prompt

Nota



: para uma versão interativa deste post, confira o


python cookbook

ou o


Javascript Notebook

do AI Studio.

1. Usando o Nano Banana Pro no Google AI Studio

Embora os usuários finais possam acessar o Nano Banana Pro no Gemini app, o melhor ambiente para desenvolvedores prototiparem e testarem prompts é o Google AI Studio. O AI Studio é um playground para experimentar todos os modelos de IA disponíveis antes de escrever qualquer código, e também é o ponto de entrada para construir com a Gemini API.

Você pode usar o Nano Banana Pro dentro do AI Studio. Para começar, acesse aistudio.google.com, faça login com sua conta do Google e selecione Nano Banana Pro (Gemini 3 Pro Image) no seletor de modelos.

Ao contrário do Nano-Banana, a versão pro não tem um nível gratuito, o que significa que você precisa selecionar uma chave de API com faturamento ativado (veja a seção "configuração do projeto" abaixo).

Google AI Studio - inline image

Dica



: Você também pode programar aplicativos web Nano Banana diretamente no AI Studio, em


ai.studio/apps

, ou explorar o código e remixar um dos


aplicativos existentes

.

2. Configuração do projeto

Para seguir este guia, você vai precisar do seguinte:

Se você já é um usuário hardcore da Gemini API com tudo isso, ótimo! Só pule esta seção e vá para a próxima. Caso contrário, veja como começar:

Etapa A: Obtenha sua Chave de API

Quando você faz login pela primeira vez no AI Studio, um projeto do Google Cloud e uma chave de API devem ser criados automaticamente.

Abra a tela de gerenciamento de chaves de API e clique no ícone "copiar" para copiar sua chave de API.

Google AI Studio - inline image

Etapa B: Ative o Faturamento

Como o Nano Banana Pro não tem um nível gratuito, você precisa ativar o faturamento no seu projeto do Google Cloud.

Na tela de gerenciamento de chaves de API, clique em Configurar faturamento ao lado do seu projeto e siga as instruções na tela.

Google AI Studio - inline image

Quanto custa o Nano Banana Pro?

A geração de imagens com o Nano Banana Pro é mais cara que a versão Flash, especialmente para imagens em 4K. No momento em que este post foi publicado, uma imagem em 1K ou 2K custa $0.134, enquanto uma em 4K custa $0.24 (mais o custo de token da entrada e da saída de texto).

Consulte os preços na documentação para obter os detalhes mais recentes.

Dica profissional



: Para economizar 50% nos custos de geração, você pode usar a


Batch API

. Em troca, talvez você precise esperar até 24h para receber suas imagens.

Etapa C: Instale o SDK

Escolha o SDK para a linguagem de sua preferência.

Python:

text
1pip install -U google-genai
2# Instale a biblioteca Pillow para manipulação de imagens
3pip install Pillow

JavaScript / TypeScript:

text
1npm install @google/genai

Nota



: Os exemplos a seguir usam o SDK Python para demonstração. Trechos de código equivalentes para usar o Nano Banana em JavaScript são fornecidos neste


JS Notebook

.

3. Inicializar o Client

Para usar o modelo Pro, você vai precisar usar o ID do modelo gemini-3-pro-image-preview.

python
1from google import genai
2from google.genai import types
3
4# Inicializa o client
5client = genai.Client(api_key="YOUR_API_KEY")
6
7# Define o ID do modelo
8PRO_MODEL_ID = "gemini-3-pro-image-preview"

4. Geração Básica (Os Clássicos)

Antes de mergulharmos nas coisas mais sofisticadas, vamos ver uma geração padrão. Você pode controlar a saída usando response_modalities (para obter texto e imagens ou apenas imagens) e aspect_ratio.

python
1prompt = "Crie uma imagem fotorrealista de um gato siamês com um olho esquerdo verde e um direito azul"
2aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" ou "21:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'], # Ou apenas ['Image']
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 )
12 )
13)
14
15# Exibe a imagem
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("cat.png")
Google AI Studio - inline image

O modo de chat também é uma opção (na verdade, é o que eu recomendo para edições em múltiplas etapas). Confira o 8º exemplo, "Polyglot Banana", para um exemplo.

5. O Processo de "Raciocínio"

O Nano Banana Pro não está apenas desenhando; ele está pensando. Isso significa que ele pode raciocinar através dos seus prompts mais complexos e intrincados antes de gerar uma imagem. E a melhor parte? Você pode espiar dentro do cérebro dele!

Para ativar isso, defina include_thoughts=True no thinking_config.

python
1prompt = "Crie uma imagem incomum, mas realista, que possa viralizar"
2aspect_ratio = "16:9"
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio=aspect_ratio,
11 ),
12 thinking_config=types.ThinkingConfig(
13 include_thoughts=True # Ativa os pensamentos
14 )
15 )
16)
17
18# Exibe a imagem e os pensamentos
19for part in response.parts:
20 if part.thought:
21 print(f"Pensamento: {part.text}")
22 elif image:= part.as_image():
23 image.save("viral.png")

E você deve receber algo como:

text
1## Imaginando Lhamas Comutando
2
3Estou focando nas lhamas agora. O objetivo é capturá-las como
4comutadoras diárias em um ônibus movimentado em La Paz, Bolívia. Meu plano
5envolve um ônibus vintage lotado de passageiros divertidos. A imagem
6vai destacar detalhes como uma lhama olhando pela janela,
7outra interagindo com um passageiro, enquanto as pessoas tiram
8fotos.
9
10[IMAGE]
11
12## Visualizando o Conceito
13
14Agora estou totalmente imerso no cenário solicitado. Meu foco
15principal está nos aspectos "incomum, mas realista". A cena está
16começando a tomar forma com os elementos-chave estabelecidos.
Google AI Studio - inline image

Essa transparência ajuda você a entender como o modelo interpretou seu pedido. É como ter uma conversa com seu artista!

6. Fundamentação em Pesquisa (Mágica em tempo real)

Um dos recursos mais inovadores é a Fundamentação em Pesquisa. O Nano Banana Pro não está preso no passado; ele pode acessar dados em tempo real da Pesquisa Google para gerar imagens precisas e atualizadas. Quer o clima? Você consegue.

Por exemplo, você pode pedir para ele visualizar a previsão do tempo atual:

python
1prompt = "Visualize a previsão do tempo atual para os próximos 5 dias em Tóquio como um gráfico de clima limpo e moderno. adicione um visual do que devo vestir a cada dia"
2
3response = client.models.generate_content(
4 model=PRO_MODEL_ID,
5 contents=prompt,
6 config=types.GenerateContentConfig(
7 response_modalities=['Text', 'Image'],
8 image_config=types.ImageConfig(
9 aspect_ratio="16:9",
10 ),
11 tools=[{"google_search": {}}] # Ativa a Pesquisa Google
12 )
13)
14
15# Salva a imagem
16for part in response.parts:
17 if image:= part.as_image():
18 image.save("weather.png")
19
20# Exibe as fontes (você deve sempre fazer isso)
21print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)
Google AI Studio - inline image

7. Vá Grande ou Vá pra Casa: Geração em 4K

Precisa de imagens com qualidade para impressão? O Nano Banana Pro suporta resolução 4K. Porque às vezes, maior é melhor.

python
1prompt = "Uma foto de um carvalho experimentando todas as estações"
2resolution = "4K" # Opções: "1K", "2K", "4K", cuidado, letras minúsculas não funcionam.
3
4response = client.models.generate_content(
5 model=PRO_MODEL_ID,
6 contents=prompt,
7 config=types.GenerateContentConfig(
8 response_modalities=['Text', 'Image'],
9 image_config=types.ImageConfig(
10 aspect_ratio="1:1",
11 image_size=resolution
12 )
13 )
14)
Google AI Studio - inline image

Nota



: A geração em 4K tem um custo mais alto, então use-a com sabedoria!

8. Polyglot Banana (Capacidades Multilíngues)

O modelo pode gerar e até traduzir textos dentro de imagens em mais de uma dúzia de idiomas. É basicamente um tradutor universal para os seus olhos.

python
1# Gera um infográfico em espanhol
2message = "Faça um infográfico explicando a teoria da Relatividade Geral de Einstein adequado para um aluno do 6º ano em espanhol"
3
4response = chat.send_message(message,
5 config=types.GenerateContentConfig(
6 image_config=types.ImageConfig(aspect_ratio="16:9")
7 )
8)
9
10# Salva a imagem
11for part in response.parts:
12 if image:= part.as_image():
13 image.save("relative.png")
Google AI Studio - inline image
python
1# Traduz para japonês
2message = "Traduza este infográfico para japonês, mantendo todo o resto igual"
3response = chat.send_message(message)
4
5# Salva a imagem
6for part in response.parts:
7 if image:= part.as_image():
8 image.save("relative_JP.png")
Google AI Studio - inline image

9. Misture Tudo! (Mixagem Avançada de Imagens)

Enquanto o modelo Flash pode misturar até 3 imagens, o modelo Pro pode lidar com até 14 imagens! Isso é uma festa inteira em um único prompt. Perfeito para criar colagens complexas ou mostrar toda a sua linha de produtos.

python
1# Mistura várias imagens
2response = client.models.generate_content(
3 model=PRO_MODEL_ID,
4 contents=[
5 "Uma foto de grupo no escritório dessas pessoas, elas estão fazendo caretas.",
6 PIL.Image.open('Joao.png'),
7 PIL.Image.open('Maria.png'),
8 # ... adicione até 14 imagens
9 ],
10)
11
12# Salva a imagem
13for part in response.parts:
14 if image:= part.as_image():
15 image.save("foto_grupo.png")
Google AI Studio - inline image

Nota



: Se você quiser altíssima fidelidade para seus personagens, limite-se a 5, que já é mais que suficiente para uma noite de festa!

10. Hora de Mostrar o Trabalho! (Demonstrações Exclusivas do Pro)

Aqui estão alguns exemplos do que é possível apenas com o Nano Banana Pro. Prepare-se para ficar impressionado:

Pixel Art Personalizada (Fundamentação em Pesquisa)

Prompt



: "Pesquise na web e então gere uma imagem em perspectiva isométrica, pixel art detalhada que mostre a carreira de Guillaume Vernade"

Isso usa a fundamentação em pesquisa para encontrar informações específicas sobre uma pessoa e as visualiza em um estilo específico.

Google AI Studio - inline image

Integração Complexa de Texto

Prompt



: "Me mostre um infográfico sobre como os sonetos funcionam, usando um soneto sobre bananas escrito nele, junto com uma longa análise literária do poema. Com uma estética vintage bacana"

O modelo pode gerar textos coerentes e longos e integrá-los perfeitamente a um layout complexo.

Google AI Studio - inline image

Mockups de Alta Fidelidade

Prompt



: "Uma foto de um programa do show da Broadway sobre jogadores de TCG em um belo assento de teatro, é profissional e bem feito, brilhante, podemos ver a capa e uma página mostrando uma foto do palco."

Crie mockups fotorrealistas de materiais impressos com iluminação e textura precisas.

Google AI Studio - inline image

11. Melhores Práticas e Dicas de Prompt para Nano Banana e Nano Banana Pro

Para obter os melhores resultados com os modelos Nano Banana, siga estas diretrizes de prompting:

Seja Hiperespecífico: Quanto mais detalhes você fornecer sobre assuntos, cores, iluminação e composição, mais controle terá sobre a saída.

Forneça Contexto e Intenção: Explique o propósito ou o clima desejado da imagem. A compreensão do contexto pelo modelo influenciará suas escolhas criativas.

Itere e Refine: Não espere a perfeição na primeira tentativa. Use a capacidade conversacional do modelo para fazer mudanças incrementais e refinar sua imagem.

Use Instruções Passo a Passo: Para cenas complexas, divida seu prompt em uma série de instruções claras e sequenciais.

Use Enquadramento Positivo: Em vez de prompts negativos como "sem carros", descreva a cena desejada de forma positiva: "uma rua vazia e deserta, sem sinais de trânsito."

Controle a Câmera: Use termos fotográficos e cinematográficos para direcionar a composição, como "foto grande angular", "macro" ou "perspectiva de ângulo baixo".

Use a fundamentação em pesquisa a seu favor: Quando você sabe que quer que o modelo use dados em tempo real ou do mundo real, seja muito preciso sobre isso. "Pesquise na web sobre o último jogo do Olympique Lyonnais e faça um infográfico" vai funcionar melhor do que apenas "um infográfico dos últimos jogos do OL" (que ainda deve funcionar, mas não arrisque).

Use a Batch API para reduzir seus custos e obter mais cota: A Batch API é uma forma de enviar lotes pequenos ou muito grandes de solicitações juntos. Eles podem levar até 24 horas para serem processados, mas em troca você pode economizar 50% nos custos de geração. E a cota também é maior!

Para um mergulho mais profundo nas melhores práticas, confira o guia de prompting na documentação e as melhores práticas de prompting para o Nano Banana publicadas no blog oficial.

Concluindo

O Nano Banana Pro (Gemini 3 Pro Image) abre uma nova fronteira para a geração de imagens por IA. Com sua capacidade de pensar, pesquisar e renderizar em 4K, é uma ferramenta para criadores sérios (e diversão séria).

Pronto para experimentar? Vá para o Google AI Studio, experimente ou personalize nossos Apps ou confira o cookbook.

Salvar com um clique

Faça leitura profunda de artigos virais com IA no YouMind

Salve a fonte, faça perguntas específicas, resuma o argumento e transforme um artigo viral em notas reutilizáveis em um único espaço de trabalho com IA.

Explorar o YouMind
Para criadores

Transforme seu Markdown em um artigo 𝕏 impecável

Quando você publica seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown em um artigo 𝕏 impecável e pronto para publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais