Processo completo de integração da API Nano Banana 2: explicação detalhada dos passos de compra oficiais e recomendações de serviços proxy de API alternativos

Nota do autor: Guia passo a passo completo sobre o processo de compra para integração oficial da Nano Banana 2 (via vinculação de cartão no AI Studio + configuração no Vertex AI), análise das restrições de rede para usuários fora dos EUA e como a APIYI atua como uma solução de backup para atender às demandas do seu negócio.

No artigo anterior, falamos sobre a integração do Nano Banana Pro. Hoje, vamos abordar o seu "irmão", o Nano Banana 2 (gemini-3.1-flash-image-preview). Embora ambos utilizem o modelo de imagem Gemini, o processo de integração do NB2 tem algumas particularidades — em março de 2026, o AI Studio alterou seu sistema de cobrança (para um modelo pré-pago) e a configuração no Vertex AI também apresenta diferenças. Este artigo guiará você por cada etapa do processo oficial de compra e, em seguida, apresentará a APIYI como uma alternativa de backup — garantindo que você possa "conectar-se diretamente ao oficial", mas também assegurando que seu negócio não pare caso o serviço oficial falhe ou atinja limites de cota.

Valor central: Conclua todo o processo de compra oficial, entenda os custos e barreiras de cada etapa e prepare a APIYI como uma solução de backup para garantir a continuidade do seu negócio.

Informações essenciais para integração oficial da API Nano Banana 2

Fluxo 1: Integração via compra no AI Studio (passo a passo completo)

O AI Studio é a porta de entrada preferida da maioria dos desenvolvedores. Em março de 2026, o sistema de cobrança foi alterado — passando da cobrança vinculada ao GCP para um modelo de pré-pagamento/pós-pagamento integrado ao próprio AI Studio.

Passo 1: Criar uma conta Google e acessar o AI Studio

Atenção aos usuários na China: Você precisará de uma VPN para acessar o AI Studio. Além disso, mesmo com VPN, o Google detecta a região de registro da conta — recomenda-se usar uma conta Gmail dos EUA.

Passo 2: Gerar a chave API

Neste ponto, você obteve uma chave de nível gratuito — o Nano Banana 2 é praticamente inutilizável no nível gratuito (RPD extremamente baixo ou nulo), sendo necessário atualizar para o nível pago.

Passo 3: Vincular forma de pagamento e recarregar

Desde 23 de março de 2026, o AI Studio utiliza um novo sistema de cobrança:

Passos para recarga pré-paga:

1. Acesse a página Billing no AI Studio
2. Clique em "Buy Credits"
3. Escolha o valor da recarga ($10 / $50 / $100 / personalizado, até $5.000)
4. Insira as informações do cartão de crédito

Cartões de crédito suportados: Visa, Mastercard, American Express, Discover, JCB

Barreira para usuários na China: Requer um cartão de crédito internacional. Cartões UnionPay locais não são aceitos. Você precisará de um cartão de crédito internacional (Visa/Mastercard) ou utilizar um serviço de cartão de crédito virtual.

Passo 4: Escrever o código para a invocação do modelo

from google import genai
from google.genai import types

# Substitua pela sua chave API obtida no AI Studio
client = genai.Client(api_key="YOUR_AI_STUDIO_KEY")

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents=["Um golden retriever correndo na praia, sol da tarde"],
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            image_size="4K",
            aspect_ratio="16:9"
        ),
    )
)

for part in response.parts:
    if image := part.as_image():
        image.save("output.png", format="PNG")

Passo 5: Monitorar uso e custos

O processo completo leva cerca de 30 a 45 minutos (incluindo o tempo de verificação do cartão de crédito).

Fluxo 2: Aquisição e Acesso via Vertex AI (Nível Corporativo)

O Vertex AI é a escolha ideal para usuários corporativos que precisam de SLA, controle de permissões via IAM e certificações de conformidade.

Visão geral das etapas de acesso ao Vertex AI

Tempo total estimado: 2 a 3 horas.

Precificação do Vertex AI

Exatamente igual ao AI Studio — US$ 0,067 por 2K, US$ 0,151 por 4K. Sem descontos.

O valor agregado do Vertex AI consiste em: garantia de SLA de 99,9%, permissões granulares de IAM, isolamento de rede VPC e cotas de RPM personalizáveis.

Restrições de rede do Vertex AI

Assim como no AI Studio, não é possível conectar diretamente ao aiplatform.googleapis.com a partir da China continental ou da Rússia. Usuários corporativos geralmente precisam implantar um servidor intermediário em Singapura ou no Japão para atuar como um serviço proxy de API.

Solução de contingência da APIYI: Por que adotar o "sistema de via dupla"?

Alguns desenvolvedores perguntam: se a APIYI é mais barata e simples, por que manter a conexão direta oficial?

Cenários onde a conexão direta oficial serve como contingência

Cenários onde a APIYI serve como contingência (mais comuns)

Arquitetura recomendada: Priorize a APIYI (economia + estabilidade) e mantenha a oficial como reserva (claro, se a oficial cair, não há o que fazer).

Código de integração da APIYI (apenas uma linha diferente do oficial)

import openai

# Integração APIYI: altere apenas uma linha base_url
client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{
        "role": "user",
        "content": "Um golden retriever correndo na praia, luz do sol da tarde"
    }]
)

import openai

# Principal: APIYI (barata + estável)
apiyi_client = openai.OpenAI(
    api_key="APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Contingência: Conexão direta oficial
from google import genai
official_client = genai.Client(api_key="GOOGLE_KEY")

def generate_image(prompt: str):
    """Via dupla: APIYI primeiro, fallback para o oficial em caso de falha"""
    try:
        # Primeira escolha: APIYI ($0,045/imagem, estável)
        response = apiyi_client.chat.completions.create(
            model="gemini-3.1-flash-image-preview",
            messages=[{"role": "user", "content": prompt}]
        )
        return response, "apiyi"
    except Exception as e:
        print(f"Falha na APIYI: {e}, alternando para conexão direta oficial...")
        try:
            # Contingência: Conexão direta oficial ($0,151/imagem)
            from google.genai import types
            response = official_client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=[prompt],
                config=types.GenerateContentConfig(
                    response_modalities=["TEXT", "IMAGE"],
                ),
            )
            return response, "official"
        except Exception as e2:
            print(f"Falha também no oficial: {e2} (se o oficial cair, realmente não há como)")
            return None, "both_failed"

🎯 Sugestão de arquitetura: Use a APIYI no dia a dia (economia + estabilidade) e mantenha o caminho de código da conexão direta oficial. Se a APIYI cair, mude para o oficial; se o oficial cair, mude para a APIYI — um servindo de backup para o outro, garantindo que seu negócio nunca pare (a menos que ambos caiam, o que indicaria uma falha na infraestrutura do Google).

Diferenças de integração oficial: Nano Banana 2 vs Nano Banana Pro

Se você leu o artigo anterior sobre o NB Pro, aqui estão as principais diferenças de integração do NB2:

Perguntas Frequentes

Resumo

Pontos principais para a integração da API Nano Banana 2:

1. Ambos os caminhos oficiais exigem cartão e preço cheio: O AI Studio leva 30 minutos para configurar, mas exige cartão internacional + preço cheio de $0,151/imagem; o Vertex AI leva de 2 a 3 horas, mas oferece SLA. Ambos não permitem conexão direta na China/Rússia.
2. O APIYI é a melhor solução para redundância e redução de custos: Integração em 5 minutos, $0,045 por 4K (28% do preço), conexão direta global, sem necessidade de cartão internacional, cobrança por uso e sem cobrança em caso de falha. Atende à grande maioria das necessidades de negócio.
3. Arquitetura de via dupla é a mais segura: Use o APIYI para economizar no dia a dia e mantenha o caminho do código oficial como backup. Ambos servem de redundância um para o outro, garantindo que seu negócio nunca pare (se o oficial cair, realmente não há o que fazer, mas esse colapso total é extremamente raro).

Recomendamos integrar a API Nano Banana 2 através do APIYI apiyi.com — $0,045 por 4K, conexão direta global, configuração em 5 minutos e créditos de teste gratuitos ao se registrar.

📚 Referências

1. Guia oficial do desenvolvedor Nano Banana 2: Tutorial do Google para integração e uso do NB2

   • Link: blog.google/innovation-and-ai/technology/developers-tools/build-with-nano-banana-2/
   • Descrição: Contém capacidades do modelo, exemplos de código e melhores práticas

2. Documentação de cobrança do AI Studio: Novo sistema de cobrança pré-paga/pós-paga

   • Link: ai.google.dev/gemini-api/docs/billing
   • Descrição: Explicação detalhada do novo sistema de 23/03/2026

3. Limites de taxa da API Gemini: Limites oficiais e explicação dos níveis

   • Link: ai.google.dev/gemini-api/docs/rate-limits
   • Descrição: Limites específicos para o nível gratuito/Tier 1/Tier 2/Tier 3

4. Central de documentação APIYI: Guia de integração do Nano Banana 2 a $0,045/4K

   • Link: docs.apiyi.com
   • Descrição: Integração em 5 minutos + conexão direta global + cobrança por uso + sem cobrança em caso de falha

Autor: Equipe técnica da APIYI
Troca de conhecimentos: Sinta-se à vontade para discutir na seção de comentários. Para mais materiais, acesse a central de documentação da APIYI em docs.apiyi.com