description: Guia completo do Nano Banana 2: compare a API oficial do Google com a APIYI. Aprenda parâmetros, proporções exclusivas e como economizar em suas gerações de imagem.
Nota do Autor: Detalhes da documentação de desenvolvimento do Nano Banana 2 (gemini-3.1-flash-image-preview), comparando a API oficial do Google e as duas soluções de integração da plataforma APIYI, incluindo exemplos de código completos, configurações de parâmetros e estratégias para economizar.
Para desenvolvedores que desejam integrar o Nano Banana 2, existem agora duas documentações de desenvolvimento que podem ser consultadas: a documentação oficial do Google (ai.google.dev/gemini-api/docs/image-generation) e a documentação da plataforma APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).
Ambas as soluções têm suas vantagens — a documentação oficial oferece todos os recursos, enquanto a documentação da APIYI é mais simples de integrar e tem preços a partir de $0.03 por chamada. Este artigo integra e compara o conteúdo principal de ambas as documentações para ajudá-lo a escolher o método de acesso mais adequado.
Valor Central: Ao ler este artigo, você dominará os parâmetros completos da API do Nano Banana 2, exemplos de código para as duas soluções de integração e a escolha ideal para diferentes cenários.
Comparação de preços: Duas opções para o Nano Banana 2
| Modelo | Preço Padrão Oficial | Preço Batch Oficial | Preço APIYI | APIYI vs Oficial |
|---|---|---|---|---|
| Nano Banana 2 | $0.067/imagem (1K) | $0.034/imagem | $0.03/invocação | 55% mais barato |
| Nano Banana Pro | $0.134/imagem | $0.067/imagem | $0.05/invocação | 63% mais barato |
| Nano Banana (1ª Geração) | $0.039/imagem | — | $0.025/invocação | 36% mais barato |
Comparação de custo mensal do Nano Banana 2 (1.000 imagens por dia)
| Opção | Custo Mensal (Resolução 1K) | Custo Anual |
|---|---|---|
| Padrão Oficial | $2.010 | $24.120 |
| Batch Oficial | $1.020 | $12.240 |
| APIYI | $900 | $10,800 |
O valor de $0.03/invocação da APIYI não é apenas 55% mais barato que o preço padrão oficial, mas é inclusive inferior ao preço de metade do valor do Batch oficial ($0.034) — e com a vantagem do retorno em tempo real, sem precisar esperar 24 horas pelo processamento assíncrono.
🎯 Estratégia de economia: Ao realizar a invocação do modelo Nano Banana 2 através da APIYI (apiyi.com), 1.000 imagens diárias custam apenas $30, totalizando um custo mensal de $900. Ao se cadastrar, você ganha saldo de teste gratuito, e uma única chave API suporta o Nano Banana 2, Pro e outros modelos de ponta.
Guia de Desenvolvimento: Recursos Avançados do Nano Banana 2
Edição de imagens em múltiplas rodadas de conversa
O Nano Banana 2 permite modificar continuamente a mesma imagem dentro de um fluxo de diálogo:
# Formato de edição multi-rodada usando APIYI + OpenAI
messages = [
{"role": "user", "content": "Gere um logo de marca em estilo minimalista, tons de azul"},
# Após o retorno da primeira rodada, continue editando
{"role": "assistant", "content": "[Resultado da primeira geração]"},
{"role": "user", "content": "Mude a cor para um roxo degradê e adicione o nome da empresa 'TechFlow'"}
]
response = client.chat.completions.create(
model="gemini-3.1-flash-image-preview",
messages=messages
)
Geração com imagens de referência no Nano Banana 2
| Tipo de referência | Quantidade máxima | Uso |
|---|---|---|
| Referência de objeto | 10 imagens | Manter a consistência de detalhes do objeto (fotos de produtos, acessórios, etc.) |
| Referência de pessoa | 4 imagens | Manter a consistência facial e da imagem da pessoa (personagens, humanos virtuais, etc.) |
| Total | 14 imagens | Máximo de 14 imagens de referência por invocação |
Seleção do modo Thinking no Nano Banana 2
| Modo | Cenários aplicáveis | Velocidade | Qualidade | Custo adicional |
|---|---|---|---|---|
| Minimal (Padrão) | Geração cotidiana, cenários simples | Rápido | Padrão | Poucos tokens de Thinking |
| High | Composições complexas, textos precisos, cenários com múltiplos elementos | Mais lento | Superior | Mais tokens de Thinking |
🎯 Dica de desenvolvimento: Os tokens de Thinking geram cobrança independentemente de
includeThoughts=trueestar configurado ou não. Se você não precisa visualizar o processo de raciocínio, pode manter o padrão comofalse— isso não afetará a qualidade da geração, apenas não retornará o texto intermediário de inferência.
Referência de velocidade de geração do Nano Banana 2
| Resolução | Velocidade real no APIYI | Descrição |
|---|---|---|
| 0.5K | 3-8 segundos | Mais rápida, ideal para iterações rápidas |
| 1K (padrão) | 5-10 segundos | Boa experiência para uso diário |
| 2K | 10-15 segundos | Um pouco mais lenta, mas aceitável |
| 4K | 15-25 segundos | Lenta, recomenda-se configurar timeout de 120 segundos |
| High Thinking | Alguns segundos extras | Tempo adicional na fase de raciocínio |
Sugestão: Ao realizar a invocação do modelo Nano Banana 2, recomenda-se configurar
timeout=300(300 segundos) para evitar falhas por tempo esgotado devido a oscilações na rede ou no processamento do Google. Ao utilizar o serviço proxy de API do APIYI (apiyi.com), você garante uma conexão mais estável.
Perguntas Frequentes
P1: O valor de $0.03 do APIYI inclui quais resoluções?
O valor de $0.03 por invocação no APIYI é um preço único, independentemente da resolução. Não importa se você gera imagens em 0.5K, 1K, 2K ou 4K, o custo é sempre $0.03. Comparado ao preço escalonado oficial do Google ($0.045 a $0.151), a vantagem do APIYI é ainda mais evidente nas resoluções 2K e 4K.
P2: O APIYI suporta geração conectada via Image Search?
A geração conectada via Image Search é um recurso avançado do Nano Banana 2 que exige a chamada através do formato de API nativa do Google. O formato REST nativo do APIYI suporta essa funcionalidade, enquanto o formato compatível com OpenAI ainda não. Se o seu cenário exige Image Search, recomendamos usar o método de invocação nativo do APIYI.
P3: Qual a diferença entre as duas documentações e qual devo consultar?
Documentação oficial do Google (ai.google.dev): É a mais completa, contendo detalhes sobre todos os parâmetros, modo Thinking, Image Search, Thought Signature e outras funções avançadas. Ideal para desenvolvedores que precisam explorar todas as capacidades do modelo.
Documentação do APIYI (docs.apiyi.com): Mais direta e prática, focada em integração rápida e exemplos de código. Perfeita para quem quer começar logo e usar o Nano Banana 2 com o menor custo. Sugerimos começar pela documentação do APIYI para um setup rápido e consultar a do Google conforme precisar de recursos avançados.
Resumo
Pontos principais da documentação de desenvolvimento do Nano Banana 2:
- Duas soluções com vantagens distintas: A API oficial do Google oferece recursos mais completos (Image Search, Thinking, 14 imagens de referência), enquanto a APIYI oferece o menor preço ($0,03/vez) e a integração mais simples.
- APIYI $0,03 = 45% do preço oficial: Retorno em tempo real, sendo ainda mais barato que a metade do preço do modo Batch oficial ($0,034), sem a necessidade de esperar 24 horas.
- Parâmetros principais universais: Os 4 níveis de resolução, 14 proporções de tela (aspect ratios) e o modo Thinking podem ser utilizados em ambas as soluções.
Para a maioria dos desenvolvedores, recomendamos a integração rápida via APIYI (apiyi.com) — preço de $0,03/vez, formato compatível com OpenAI e créditos gratuitos ao se cadastrar. Você poderá gerar sua primeira imagem em menos de 5 minutos.
📚 Referências
-
Documentação oficial do Google Gemini para geração de imagens: Referência completa da API Nano Banana 2
- Link:
ai.google.dev/gemini-api/docs/image-generation - Descrição: Documentação oficial de todos os parâmetros, funções e recursos avançados.
- Link:
-
Documentação do Nano Banana 2 na APIYI: Integração rápida e exemplos de código
- Link:
docs.apiyi.com/api-capabilities/nano-banana-2-image - Descrição: Guia de integração da plataforma APIYI, incluindo preços e exemplos de invocação do modelo.
- Link:
-
Preços oficiais da API Gemini: Preços exatos para cada resolução
- Link:
ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview - Descrição: Preços padrão e preços para processamento em lote (Batch) para 0.5K/1K/2K/4K.
- Link:
-
Limites de taxa (Rate Limits) da API Gemini: Restrições de chamada para modelos Preview
- Link:
ai.google.dev/gemini-api/docs/rate-limits - Descrição: Entenda as limitações de cota para os modelos em fase Preview.
- Link:
Autor: Equipe Técnica APIYI
Troca de conhecimentos: Sinta-se à vontade para compartilhar sua experiência de desenvolvimento com o Nano Banana 2 nos comentários. Para mais materiais sobre modelos de IA, visite o centro de documentação da APIYI em docs.apiyi.com.
