Guillaume Vernade para Google AI
Publicado em 21 de novembro
Apresentando o Nano Banana Pro: Tutorial Completo para Desenvolvedores
Desenvolvendo com Gemini 3 (Google AI) (Série de 6 partes)
Você amou o Nano-Banana? Criou imagens de figurinhas de todos os seus amigos e rostos fantasmagóricos atrás de todos os seus inimigos? Agora chega o não-tão-nano “modelo Gemini 3 Pro Image”, que todos vocês preferem chamar de Nano Banana Pro!
Enquanto o modelo Flash (Nano Banana) trouxe velocidade e acessibilidade, a versão Pro introduz capacidades de “pensamento”, ancoragem em pesquisas e saída de alta fidelidade em 4K. É hora de enlouquecer com tarefas criativas complexas!
Este guia irá guiá-lo pelas funcionalidades avançadas do Nano Banana Pro usando a API do Gemini Developer.
Este guia abordará:
- Usando o Nano Banana Pro no Google AI Studio
- Configuração do projeto
- Inicialização do Cliente
- Geração Básica (Os Clássicos)
- O Processo de “Pensamento”
- Ancoragem em Pesquisa
- Geração em Alta Resolução 4K
- Capacidades Multilíngues
- Mistura Avançada de Imagens
- Demonstrações Exclusivas para Pro
Nota: para uma versão interativa deste post, confira o cookbook em Python ou o Notebook em JavaScript do AI Studio.
1) Usando o Nano Banana Pro no Google AI Studio
Enquanto os usuários finais podem acessar o Nano Banana Pro no aplicativo Gemini, 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 desenvolver com a API do Gemini.
Você pode usar o Nano Banana Pro dentro do AI Studio. Para começar, vá para 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 possui uma versão gratuita, o que significa que você precisa selecionar uma chave de API com cobrança habilitada (veja a seção “configuração do projeto” abaixo).
Dica: você também pode criar aplicativos web do 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ê precisará do seguinte:
- Uma chave de API do Google AI Studio.
- Cobrança configurada para o seu projeto.
- O SDK do Google Gen AI para Python ou JavaScript/TypeScript.
Se você já é um usuário experiente da API do Gemini com tudo isso, ótimo! Apenas pule esta seção e vá para a próxima. Caso contrário, aqui está como começar:
Etapa A: Obtenha sua Chave de API
Quando você fizer 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.
Etapa B: Ative a Cobrança
Como o Nano Banana Pro não possui uma versão gratuita, você deve ativar a cobrança no seu projeto do Google Cloud.
Na tela de gerenciamento de chaves de API, clique em Configurar cobrança ao lado do seu projeto e siga as instruções na tela.
Quanto custa o Nano Banana Pro?
A geração de imagens com o Nano Banana Pro é mais cara do que a versão Flash, especialmente para imagens 4K. No momento em que este post foi publicado, uma imagem de 1K ou 2K custa $0,134, enquanto uma de 4K custa $0,24 (mais o custo de tokens da entrada e da saída de texto).
Confira a tabela de preços na documentação para os detalhes mais recentes.
Dica profissional: para economizar 50% nos custos de geração, você pode usar a API em lote. Em troca, você pode ter que esperar até 24h para receber suas imagens.
Etapa C: Instale o SDK
Escolha o SDK para sua linguagem preferida.
Python:
pip install -U google-genai
# Instale a biblioteca Pillow para manipulação de imagens
pip install Pillow
JavaScript / TypeScript:
npm install @google/genai
Nota: os exemplos a seguir usam o SDK do Python para demonstração. Trechos de código equivalentes para usar o Nano Banana em JavaScript são fornecidos neste Notebook em JS.
3) Inicialização do Cliente
Para usar o modelo Pro, você precisará usar o ID do modelo gemini-3-pro-image-preview.
from google import genai
from google.genai import types
# Inicialize o cliente
client = genai.Client(api_key="SUA_CHAVE_DE_API")
# Defina o ID do modelo
PRO_MODEL_ID = "gemini-3-pro-image-preview"
4) Geração Básica (Os Clássicos)
Antes de entrarmos nas coisas sofisticadas, vamos dar uma olhada em 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.
prompt = "Crie uma imagem fotorealista de um gato siamês com olho esquerdo verde e direito azul"
aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" ou "21:9"
response = client.models.generate_content(
model=PRO_MODEL_ID,
contents=prompt,
config=types.GenerateContentConfig(
response_modalities=['Text', 'Image'], # Ou apenas ['Image']
image_config=types.ImageConfig(
aspect_ratio=aspect_ratio,
)
)
)
# Salve a imagem
for part in response.parts:
if image:= part.as_image():
image.save("cat.png")
O modo de chat também é uma opção (na verdade, é o que eu recomendaria para edição de múltiplas rodadas). Confira o exemplo 8, “Polyglot Banana”, para um exemplo.
5) O Processo de “Pensamento” (Está vivo!)
O Nano Banana Pro não está apenas desenhando; ele está pensando. Isso significa que ele pode raciocinar sobre suas solicitações mais complexas e tortas antes de gerar uma imagem. E o melhor parte? Você pode dar uma olhada na mente dele!
Para habilitar isso, defina include_thoughts=True no thinking_config.
prompt = "Crie uma imagem incomum, mas realista, que possa viralizar"
aspect_ratio = "16:9"
response = client.models.generate_content(
model=PRO_MODEL_ID,
contents=prompt,
config=types.GenerateContentConfig(
response_modalities=['Text', 'Image'],
image_config=types.ImageConfig(
aspect_ratio=aspect_ratio,
),
thinking_config=types.ThinkingConfig(
include_thoughts=True # Habilitar pensamentos
)
)
)
# Salve a imagem e os pensamentos
for part in response.parts:
if part.thought:
print(f"Pensamento: {part.text}")
elif image:= part.as_image():
image.save("viral.png")
E você deve obter algo como:
## Imaginando Comutadores de Lhamas
Estou me concentrando nas lhamas agora. O objetivo é capturá-las como passageiros diários em um ônibus movimentado em La Paz, Bolívia. Meu plano envolve um ônibus vintage lotado com passageiros divertidos. A imagem destacará detalhes como uma lama olhando pela janela, outra interagindo com um passageiro, enquanto as pessoas tiram fotos.
[IMAGEM]
## Visualizando o Conceito
Agora estou totalmente imerso na cena solicitada. Meu foco principal está nos aspectos "incomuns, mas realistas". A cena está começando a tomar forma com os elementos principais estabelecidos.
Essa transparência ajuda você a entender como o modelo interpretou sua solicitação. É como ter uma conversa com seu artista!
6) Ancoragem em Pesquisa (Magia em tempo real)
Um dos recursos mais transformadores é a Ancoragem em Pesquisa. O Nano Banana Pro não está preso ao passado; ele pode acessar dados em tempo real do Google Search para gerar imagens precisas e atualizadas. Quer o tempo? Você tem.
Por exemplo, você pode pedir para visualizar a previsão do tempo atual:
prompt = "Visualize a previsão do tempo dos próximos 5 dias em Tóquio como um gráfico de tempo limpo e moderno. adicione uma visualização do que eu devo usar cada dia"
response = client.models.generate_content(
model=PRO_MODEL_ID,
contents=prompt,
config=types.GenerateContentConfig(
response_modalities=['Text', 'Image'],
image_config=types.ImageConfig(
aspect_ratio="16:9",
),
tools=[{"google_search": {}}] # Habilitar o Google Search
)
)
# Salve a imagem
for part in response.parts:
if image:= part.as_image():
image.save("weather.png")
# Exiba as fontes (você deve sempre fazer isso)
print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)
7) Vá Grande ou Vá para Casa: Geração em 4K
Precisa de imagens de qualidade de impressão? O Nano Banana Pro suporta resolução 4K. Porque às vezes, maior é melhor.
prompt = "Uma foto de uma árvore de carvalho experimentando todas as estações"
resolution = "4K" # Opções: "1K", "2K", "4K", tenha cuidado com letras minúsculas, não funcionam.
response = client.models.generate_content(
model=PRO_MODEL_ID,
contents=prompt,
config=types.GenerateContentConfig(
response_modalities=['Text', 'Image'],
image_config=types.ImageConfig(
aspect_ratio="1:1",
image_size=resolution
)
)
)
Nota: a geração em 4K tem um custo mais alto, então use com sabedoria!
8) Banana Poliglota (Capacidades Multilíngues)
O modelo pode gerar e até traduzir texto dentro de imagens em mais de uma dúzia de idiomas. É basicamente um tradutor universal para seus olhos.
# Gere um infográfico em espanhol
message = "Faça um infográfico explicando a teoria da relatividade geral de Einstein adequado para um aluno do 6º ano em espanhol"
response = chat.send_message(message,
config=types.GenerateContentConfig(
image_config=types.ImageConfig(aspect_ratio="16:9")
)
)
# Salve a imagem
for part in response.parts:
if image:= part.as_image():
image.save("relativity.png")
# Traduza para japonês
message = "Traduza este infográfico para o japonês, mantendo tudo o mais igual"
response = chat.send_message(message)
# Salve a imagem
for part in response.parts:
if image:= part.as_image():
image.save("relativity_JP.png")
9) Misture tudo! (Mistura 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.
# Misture múltiplas imagens
response = client.models.generate_content(
model=PRO_MODEL_ID,
contents=[
"Uma foto de grupo de escritório dessas pessoas, elas estão fazendo caras engraçadas.",
PIL.Image.open('John.png'),
PIL.Image.open('Jane.png'),
# ... adicione até 14 imagens
],
)
# Salve a imagem
for part in response.parts:
if image:= part.as_image():
image.save("group_picture.png")
Nota: se você quiser alta fidelidade para seus personagens, limite-se a 5, o que já é mais do que suficiente para uma noite de festa!
10) Hora de se exibir! (Demonstrações Exclusivas para Pro)
Aqui estão alguns exemplos do que é possível apenas com o Nano Banana Pro. Prepare-se para se impressionar:
Arte Pixel Personalizada (Ancoragem em Pesquisa)Prompt: “Pesquise na web e gere uma imagem de perspectiva isométrica, arte pixelizada detalhada que mostre a carreira de Guillaume Vernade”
Isso usa o aterramento de pesquisa para encontrar informações específicas sobre uma pessoa e visualizá-las em um estilo específico.
Integração de Texto Complexo
Prompt: “Mostre-me um infográfico sobre como funcionam os sonetos, usando um soneto sobre bananas escrito nele, junto com uma longa análise literária do poema. Boa estética vintage”
O modelo pode gerar texto coerente e longo, integrando-o perfeitamente em um layout complexo.
Maquetes de Alta Fidelidade
Prompt: “Uma foto de um programa do show da Broadway sobre jogadores de TCG em um bom assento de teatro, é profissional e bem feito, brilhante, podemos ver a capa e uma página mostrando uma foto do palco.”
Crie maquetes fotorealistas de materiais impressos com iluminação e textura precisas.
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 prompt:
Seja hiperespecífico: Quanto mais detalhes você fornecer sobre os assuntos, cores, iluminação e composição, maior será o controle sobre a saída.
Forneça contexto e intenção: Explique o propósito ou o humor desejado da imagem. A compreensão do modelo sobre o contexto influenciará suas escolhas criativas.
Itere e refine: Não espere perfeição na primeira tentativa. Use a capacidade conversacional do modelo para fazer alterações 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 formulação positiva: Em vez de prompts negativos como “sem carros”, descreva a cena desejada positivamente: “uma rua vazia e deserta sem sinais de tráfego”.
Controle a câmera: Use termos fotográficos e cinematográficos para direcionar a composição, como “tiro em grande angular”, “tiro macro” ou “perspectiva em ângulo baixo”.
Aproveite o aterramento de pesquisa: Quando você souber que deseja que o modelo use dados em tempo real ou do mundo real, seja muito preciso. “Pesquise na web sobre o último jogo do Lyon nas Olimpíadas e faça um infográfico” funcionará melhor do que apenas “um infográfico dos últimos jogos do OL” (que ainda deve funcionar, mas não arrisque).
Use a API em lote Batch API para reduzir seus custos e obter mais cota: A API em lote é uma forma de enviar pequenos ou muito grandes lotes 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 uma análise mais aprofundada das melhores práticas, consulte o guia de prompt na documentação e as melhores práticas de prompt para Nano Banana publicadas no blog oficial.
Conclusão
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 muito divertida).
Pronto para experimentar? Acesse o Google AI Studio, experimente ou personalize nossos Aplicativos ou confira o cookbook.
