GUIA TÉCNICO Publicado

Gemini API e Vertex AI (agora Agent Platform): Guia Completo para Integrar IA Generativa à Sua Empresa

Tudo o que você precisa saber para escolher a plataforma certa, entender os preços e levar os modelos Gemini para produção — com dados verificados de fontes oficiais do Google Cloud .

Emmanuel Armendariz
Emmanuel Armendariz
The Cloud Collective · · 12 min de leitura

O Google oferece acesso aos seus modelos Gemini por meio de duas portas principais: a API Gemini para desenvolvedores (também conhecida como Google AI Studio) e a Gemini API na Gemini Enterprise Agent Platform (anteriormente Vertex AI ). Ambas dão acesso aos mesmos modelos, mas são projetadas para públicos e necessidades muito distintos.

Se a sua empresa está avaliando como integrar inteligência artificial generativa em seus produtos, processos ou aplicativos, este guia ajudará você a entender as principais diferenças, os preços atualizados e os casos de uso reais que estão impulsionando empresas de todos os portes.

API Gemini para desenvolvedores — O caminho mais rápido para desenvolvedores. Chave API direta, nível free generoso, ideal para protótipos e aplicações de pequeno a médio porte.

Plataforma de Agentes da API Gemini — A plataforma enterprise . Segurança avançada com IAM, residência de dados, SLA garantido, integração com BigQuery e Cloud Storage, e mais de 200 modelos no Model Garden.

A grande novidade é que ambas APIs agora compartilham o SDK de IA Generativa do Google unificado, o que permite migrar de uma para a outra com alterações mínimas no código:

// API Gemini para desenvolvedores
const ai = novo GoogleGenAI({ apiKey: sua chave api API });

// Agent Platform (anteriormente Vertex AI ) — mesma biblioteca, uma linha diferente
const ai = novo GoogleGenAI({ vertexai: verdadeiro, projeto: seu-projeto, localização: "europe-west1" });

Comparação direta

Mesmos modelos, porta de entrada diferente. Aqui estão as diferenças que importam:

Característica API Gemini para desenvolvedores Plataforma de Agentes da API Gemini
AudiênciaDesenvolvedores, startups, protótiposEmpresas, equipes de ML, produção em escala
AutenticaçãoChave de API simplesIAM + Contas de serviço
Nível FreeSim — tokens gratuitos em modelos selecionadosUS$ 300 em créditos para novos usuários + prévias gratuitas
SLA garantidoNãoSim — SLA da Agent Platform
Residência de dadosNão configurávelEndpoints regionais (UE, EUA, Ásia...)
Integração em nuvemLimitadaBigQuery , Cloud Storage, Agent Studio, Model Garden
ModelosGemini , Nano Banana, Veo e OmniMais de 200 ( Gemini , Claude , Llama, Gemma, DeepSeek…)
FaturamentoPré-pago (o Google AI Studio está migrando as contas de pós-pago para pré-pago)Google Cloud Billing com descontos por volume
SDKSDK unificado de IA generativa do Google (Python, Node.js , Go, REST)

Modelos Gemini e preços — Setembro de 2026

✓ Verificado ai.google.dev/ gemini - api /docs/pricing — 29 de setembro de 2026

A família atual é a geração 3.x. Os modelos 2.5 continuam ativos, mas o Google limita o acesso a quem já os utilizava e recomenda o 3.8 Flash ou o 3.5 Flash-Lite para novos projetos. Todos suportam uma janela de contexto de 1 milhão de tokens.

MAIS AVANÇADO
Prévia Gemini 3.1 Pro

O modelo mais capaz para raciocínio complexo, multimodal e agentes.

Entrada ≤200 milUS$ 2,00/1 milhão de tokens
Produção ≤200 milUS$ 12,00/1 milhão de tokens
Entrada >200 milUS$ 4,00/1 milhão de tokens
Produção >200 milUS$ 18,00/1 milhão de tokens
Gemini 3.8 Flash

O Flash mais inteligente do Google: agentes autônomos, desenvolvimento de software e fluxos de trabalho empresariais complexos.

EntradaUS$ 0,75/1 milhão de tokens
Resultado (incl. raciocínio)US$ 3,75/1 milhão de tokens
A partir de 1º/01/2027$1.50 / $7.50
Nível Free disponível
Gemini 3.5 Flash-Lite

Modelo eficiente para tarefas de agentes de alto volume, tradução e processamento de dados.

Entrada (texto/imagem/vídeo/áudio)US$ 0,30/1 milhão de tokens
Resultado (incl. raciocínio)US$ 2,50/1 milhão de tokens
Nível Free disponível
Gemini 3.1 Flash-Lite

O mais econômico da geração atual. Retirada prevista a partir de 07/05/2027 (substituto: 3.5 Flash-Lite).

Entrada (texto/imagem/vídeo)US$ 0,25/1 milhão de tokens
Entrada (áudio)US$ 0,50/1 milhão de tokens
Resultado (incl. raciocínio)US$ 1,50/1 milhão de tokens
Nível Free disponível

⚠ Modelos removidos e alterações: Gemini 3 Pro Preview foi descontinuado em 09/03/2026 (substituto: 3.1 Pro Preview). Gemini 2.0 Flash e o 2.0 Flash-Lite foram descontinuados em 01/06/2026. O Imagen 4 deixou de estar disponível na Gemini API em 17/08/2026 (substituto: Gemini 3.1 Flash Image), e o Veo 2.0/3.0, em 30/06/2026 (substituto: Veo 3.1). O substituto recomendado para Gemini 3 Flash Preview é o 3.6 Flash. Se você utiliza algum desses modelos, planeje a migração.

Os modelos Gemini 3 suportam a API de lote e a inferência Flex, que reduzem os custos em 50%. Para fluxos de trabalho que não exigem resposta imediata, é a maneira mais direta de reduzir a fatura.

No nível pago, estão incluídos 5.000 pesquisas de Grounding com o Google Search gratuitas por mês (compartilhadas entre os modelos Gemini 3.x). Depois, US$ 14 a cada 1.000. O Grounding com o Google Maps segue a mesma estrutura.

Além dos modelos de texto/raciocínio, o Google oferece: Gemini 3.8 Live para voz em tempo real, Imagem Gemini 3 Pro y 3.1 Imagem Flash (Nano Banana) para geração de imagens, Gemini Omni Flash y Veo 3.1 para vídeo, e Gemini 3.8 Flash TTS para voz.

Agent Platform (anteriormente Vertex AI ): muito mais do que uma API de modelos

Enquanto a Gemini Developer API é uma porta de entrada direta para os modelos, a Agent Platform é um ecossistema completo para criar, implantar e governar aplicações de IA em escala empresarial.

1

Model Garden: +200 modelos em uma plataforma

Gemini , Claude da Anthropic , Llama, Gemma, DeepSeek, GLM e modelos especializados. Escolha o modelo adequado para cada tarefa sem mudar de plataforma.

2

Agent Studio e Agent Runtime

Projete, implante e dimensione agentes autônomos com Agent Studio (low-code), ADK (código) e Agent Runtime (anteriormente Agent Engine, runtime gerenciado). Sessions e Memory Bank em GA, com faturamento a partir de 1º de setembro de 2026. Compatível com MCP e mais de 100 conectores enterprise .

3

Grounding com Google Search e Maps

Conecte as respostas do modelo a dados reais e atualizados da web, do Google Maps ou aos seus próprios dados empresariais com o Agent Search (anteriormente Vertex AI Search). Elimine alucinações e fundamente cada resposta.

4

Geração multimodal completa

Gemini 3.1 Flash Image para imagens, Veo 3.1 para vídeo (incluindo o Lite para escala), Chirp para conversão de fala em texto e os modelos Gemini nativos com geração de imagens com texto integrado.

5

Segurança e governança enterprise

IAM granular, VPC Service Controls, residência de dados regional (incluindo a Europa), auditoria com Cloud Logging/Monitoring. Seus dados nunca são usados para treinar modelos públicos.

6

Ambiente de prompts e avaliação (anteriormente Vertex AI Studio)

Interface visual para testar prompts, avaliar modelos (incluindo parceiros como Claude ), comparar respostas e compartilhar configurações. Seu laboratório de IA no navegador.

Empresas que já o utilizam em produção

Casos reais de empresas que integram Gemini por meio da Agent Platform (anteriormente Vertex AI ) para transformar operações:

Shopify

Criou o Sidekick, um assistente multimodal com Gemini Live API na Agent Platform (anteriormente Vertex AI ) que oferece suporte em tempo real. Os usuários esquecem que estão falando com uma IA.

UWM

Integrou o áudio nativo do Gemini para agentes de voz, gerando mais de 14.000 empréstimos e aumentando a taxa de resolução de 40% para 60%.

SightCall

Combina visão computacional e áudio nativo do Gemini para assistentes de suporte visual em tempo real com Xpert Knowledge.

Databricks e JetBrains

Relatam-se melhorias de até 15% em benchmarks enterprise ao utilizar Gemini 3.1 Pro para raciocínio sobre dados estruturados e não estruturados.

Napster

Utilize Gemini Live API para criar AI Companions que veem a tela do usuário e respondem como especialistas em conversação natural — sem a necessidade de prompting manual.

Qual escolher? Seu roteiro

O caminho recomendado é progressivo: comece gratuitamente, desenvolva com a API e escale com a Agent Platform.

Passo 1 — Experimente

Google AI Studio (grátis). Teste prompts com Gemini 3.8 Flash e o 3.5 Flash-Lite, valide seu conceito, refine sua abordagem. Custo: $0.

↓
Passo 2 — Construa

API Gemini para desenvolvedores (nível pago). Integre os modelos à sua aplicação usando uma chave API . Ative o faturamento pré-pago ao exceder o nível free .

↓
Passo 3 — Escala

Plataforma de Agentes. Quando você precisar de segurança enterprise , conformidade, SLA, residência de dados na UE ou maior confiabilidade. A migração é direta graças ao SDK unificado.

Para empresas na UE: Se a conformidade regulatória ( GDPR ) e a residência de dados forem requisitos, a Agent Platform é a escolha direta. Seus endpoints regionais na Europa garantem que seus dados sejam processados onde você precisa. A Gemini Developer API não oferece essas garantias.

Otimização de custos: pontos-chave práticos

A precificação por tokens pode escalar rapidamente em produção. Estas são as estratégias mais eficazes:

Cache de contexto

Reutilize contextos frequentes (prompts de sistema longos, documentos de referência) para reduzir os tokens de entrada faturados. O custo de armazenamento em cache é mínimo em comparação com o reprocessamento a cada vez.

Batch API — 50% de economia

Processa solicitações de forma assíncrona para reduzir a fatura pela metade. Ideal para análise em massa de documentos, geração de conteúdo em lote e pipelines de dados.

Roteamento inteligente de modelos

Use o 3.5 Flash-Lite ($0,30/1M de entrada) ou o 3.1 Flash-Lite ($0,25/1M) para tarefas rotineiras de alto volume e reserve o 3.1 Pro ($2,00/1M) para raciocínio complexo. O Model Optimizer da Agent Platform automatiza isso com um meta-endpoint único.

Níveis de pensamento

Os modelos Gemini 3 utilizam "dynamic thinking" por padrão. Controle a profundidade com o parâmetro para reduzir os tokens de saída em tarefas que não exigem raciocínio profundo.

Fique de olho no limite de 200 mil tokens.

Acima de 200 mil tokens de contexto, os modelos Pro aplicam tarifas de "long context": os inputs passam de US$ 2,00 para US$ 4,00/1M e os outputs, de US$ 12,00 para US$ 18,00/1M. Projete sua arquitetura para se manter abaixo desse limite.

Grounding inteligente

As 5.000 pesquisas gratuitas no Google Search por mês são compartilhadas entre todos os modelos Gemini 3.x. Se você utilizar o Grounding de forma intensiva, monitore o consumo para evitar cobranças de US$ 14 por 1.000 consultas.

Pronto para integrar Gemini à sua empresa?

Como Google Cloud Premier Partner , ajudamos você a escolher a plataforma certa, projetar a arquitetura e levar seu projeto de IA generativa para a produção.

Solicitar consulta gratuita hola@thecloudcollective.es