Google: Gemini 3.1 Pro Preview

Preview do Gemini com foco em raciocínio para codificação agentica e resolução de problemas complexos

gemini-3.1-pro-preview

DisponívelGoogleChatEntrada em cache 90% mais barata

Entrada / Saída-50%: $2.00 / $12.00$1.00 / $6.00
Contexto: 1M
Saída máxima: 64K
Modalidades: VisãoChat
Capacidades: Uso de ferramentasCache de promptsRaciocínio

Sobre o Gemini 3.1 Pro Preview

O Gemini 3.1 Pro é o modelo Pro do Google focado em raciocínio da linha Gemini 3.1, disponível como versão de prévia. O Google descreve inteligência avançada, resolução de problemas complexos e fortes capacidades de agente. Ele lê texto e imagens, pensa antes de responder, chama ferramentas, retorna JSON vinculado a esquema e oferece suporte a cache. É a escolha ideal quando as respostas de um modelo Flash em uma tarefa difícil não são satisfatórias.

Pontos fortes

O pensamento integrado é adequado para problemas de várias etapas, depuração e planejamento, onde uma primeira resposta incorreta é custosa.
A codificação baseada em agentes é um foco declarado, com chamada de ferramentas para ciclos de edição e teste.
Imagens e texto podem ser combinados em um único prompt para análise de diagramas, gráficos e interfaces de usuário (UI).
A saída em JSON vinculado a esquema e o suporte a cache auxiliam pipelines de produção.

Quando usar outro modelo

Por ser uma versão de prévia, o Google pode alterar o comportamento ou descontinuá-lo em favor de uma versão Pro estável.
Para chamadas simples e de alto volume, os modelos Flash e Flash-Lite respondem mais rápido e são a melhor opção.

Primeiros passos

Criar chave de API
Crie uma chave no Console e use com qualquer modelo da plataforma.

Envie sua primeira requisição

Copie o exemplo para sua linguagem e execute-o no endpoint.

Texto para textoGemini API

POST/v1beta/models/gemini-3.1-pro-preview:generateContent

Formato da API:

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-xxx" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Hello!"}]}
    ]
  }'

Preço

O preço Verified vale para o Verified, que custa menos na maioria dos modelos. O preço Official é o preço publicado pelo fabricante do modelo e vale para a rota Official, mais confiável. O Auto cobra pela rota que conclui a solicitação.

Entrada tokens <= 200K · Intervalo de tokens de entrada · <=200k

Por 1M Token

Preço Official: Entrada $2.00 / Saída $12.00 / Leitura de cache $0.20
Preço Verified: Entrada $1.00 / Saída $6.00 / Leitura de cache $0.10
Desconto: -50%

Entrada tokens > 200K · Intervalo de tokens de entrada · >200k

Por 1M Token

Preço Official: Entrada $4.00 / Saída $18.00 / Leitura de cache $0.40
Preço Verified: Entrada $2.00 / Saída $9.00 / Leitura de cache $0.20
Desconto: -50%

Preços de cache de prompt

Leitura de cache

Preço Official: $0.20
Preço Verified: $0.10
Desconto: -50%

Taxas de ferramentas

Cobrado por chamada, apenas quando o modelo utiliza a ferramenta.

Pesquisa na web

Preço Official: $0.014/busca
Preço Verified: $0.007/busca
Desconto: -50%

	Preço OfficialPor 1M Token	Preço VerifiedPor 1M Token	Desconto
Entrada tokens <= 200K · Intervalo de tokens de entrada · <=200k	Entrada $2.00 / Saída $12.00 / Leitura de cache $0.20	Entrada $1.00 / Saída $6.00 / Leitura de cache $0.10	-50%
Entrada tokens > 200K · Intervalo de tokens de entrada · >200k	Entrada $4.00 / Saída $18.00 / Leitura de cache $0.40	Entrada $2.00 / Saída $9.00 / Leitura de cache $0.20	-50%
Preços de cache de prompt
Leitura de cache	$0.20	$0.10	-50%
Taxas de ferramentasCobrado por chamada, apenas quando o modelo utiliza a ferramenta.
Pesquisa na web	$0.014/busca	$0.007/busca	-50%

Uso e atividade

A taxa de sucesso é a proporção de requisições concluídas. A latência é quanto tempo uma resposta completa leva; P95 significa que 95% das requisições terminaram dentro desse tempo.

Uso e disponibilidade

Últimas 24 horas

Requisições
Taxa de sucesso
Latência P95
Total de tokens

Desempenho do modelo

Última atualização 12 de out. de 2026, 14:10 UTC

Taxa de sucesso em 30 dias: 99,6%
Latência mediana em 7 dias: 4,9 sn=323
Latência P95 em 7 dias: 32,4 sn=323
Requisições em 30 dias: 100+
Última atividade: há 4 horas

Os dados baseiam-se em solicitações agregadas de usuários, excluindo verificações de status.

Abrir no Console

Abra Gemini 3.1 Pro Preview no Console com um prompt pronto para editar ou enviar.

Ajude-me a testar gemini-3.1-pro-preview com uma mensagem em /v1beta/models/gemini-3.1-pro-preview:generateContent. Exiba a resposta, latência e custo.

Casos de uso

Indicado para

Raciocínio
Visão

Depuração complexa
Forneça um log de build com falha e os arquivos relevantes, e peça a causa raiz e uma correção mínima.
Síntese de pesquisa
Combine vários documentos longos em uma comparação fundamentada com uma lista de perguntas em aberto.
Planejamento de agentes
Use-o como o planejador que divide uma tarefa e delega etapas para modelos mais baratos.
Análise visual
Leia uma captura de tela de painel ou diagrama de arquitetura e explique o que ele implica.

Exemplos de prompt

Este rastreamento de pilha (stack trace) aparece apenas sob carga. Os dois módulos envolvidos estão anexados; encontre a condição de corrida mais provável e proponha uma correção.

Compare estas três propostas de fornecedores quanto a risco, estrutura de custos e dependência (lock-in), e recomende uma com justificativas.

Observe este diagrama de arquitetura e liste os pontos únicos de falha.

Este modelo tem preço condicional. Totais mensais de tokens sozinhos não produzem uma estimativa confiável; use o preço detalhado para a especificação da requisição, cache e janela aplicável.

FAQ

Em que o Gemini 3.1 Pro é bom?

Raciocínio complexo, codificação baseada em agentes e análise de texto e imagens. O Google o descreve como o modelo para resolução avançada de problemas. Use configurações com foco em pensamento para tarefas difíceis e modelos mais baratos para as rotineiras.

O Gemini 3.1 Pro é estável?

Não. O Google o lista como uma prévia, o que significa que o comportamento pode mudar e o modelo pode ser substituído. Mantenha um conjunto de avaliação para que você possa detectar mudanças quando isso acontecer.

Ele chama ferramentas e retorna JSON?

Sim. Tanto a chamada de função quanto a saída com restrição de esquema são suportadas, o que o torna utilizável como planejador ou revisor em um pipeline de agente automatizado.

Quando devo escolher o 3.8 Flash?

Quando a latência importa mais do que o nível máximo de profundidade de raciocínio. O 3.8 Flash é um modelo da categoria Flash que o Google também direciona para tarefas de software de longa duração; compare ambos em seus prompts reais mais difíceis.

Quanto custa o Gemini 3.1 Pro Preview?

No TokenLab, Gemini 3.1 Pro Preview custa Entrada $1.00 / Saída $6.00 Por 1M Token. A tabela de preços acima mostra o detalhamento completo. As tarifas dependem da unidade de cobrança, da especificação e do uso. Compare condições iguais no preço detalhado do modelo; uma única tarifa não determina o custo total.

Qual a janela de contexto e o limite de saída do Gemini 3.1 Pro Preview?

O Gemini 3.1 Pro Preview aceita até 1.048.576 tokens de contexto e gera até 65.536 tokens por resposta.

Qual endpoint o Gemini 3.1 Pro Preview deve usar?

Use https://api.tokenlab.sh/v1beta/models/gemini-3.1-pro-preview:generateContent para Gemini 3.1 Pro Preview. O exemplo de requisição abaixo mostra o formato de código correspondente.

Quais operações o Gemini 3.1 Pro Preview suporta?

Gemini 3.1 Pro Preview suporta Texto para texto. Selecione uma operação acima para ver seu endpoint e exemplo de requisição.