Gemini 3.1 Pro — raciocine sobre código e documentos
O Gemini 3.1 Pro reúne texto, imagens, áudio, vídeo e PDFs em uma conversa. Escolha um nível de raciocínio, solicite texto estruturado e preserve as partes originais da conversa quando seu aplicativo chamar ferramentas. US$ 0,80 / 1M entrada · US$ 4,80 / 1M saída.
- Entrada de 1 milhão de tokens
- Saída de 65.536 tokens
- Três níveis de raciocínio
- Chamadas de funções
- Entrada multimodal
Playground
Explore o Gemini 3.1 Pro com requisições nativas. Escolha um grupo da conta, examine as configurações e envie usando seu saldo. A verificação online das capacidades está pendente.
gemini-3.1-pro-preview$0.80 entrada · $4.80 saída por milhão de tokensMais parâmetros do Gemini
Experimente um destes prompts
As mensagens são cobradas do seu saldo conforme as tarifas abaixo, como uma chamada de API. Requisições que falham não custam nada.
Preços do Gemini 3.1 Pro
Os preços do Gemini 3.1 Pro abaixo vêm das configurações atuais de cobrança. Compare os grupos disponíveis para sua conta, incluindo as tarifas de entrada, saída e entrada em cache. Requisições com mais de 200.000 tokens de entrada sem cache usam a faixa de contexto longo.
Os tamanhos de exemplo são ilustrativos. Sua cobrança se baseia nos tokens informados por cada requisição. Tarifas de processamento Standard. O limiar de 200.000 tokens é calculado com base na entrada sem cache. Tokens em cache são cobrados separadamente e não são cobrados novamente como entrada sem cache. Cobranças de ferramentas e armazenamento de cache são separados destes exemplos de tokens.
| Categoria | googlellm · ≤ 200.000 tokens de entrada sem cachePreço · 1M de tokens | googlellm · > 200.000 tokens de entrada sem cachePreço · 1M de tokens | googlellm-vertext · ≤ 200.000 tokens de entrada sem cachePreço · 1M de tokens | googlellm-vertext · > 200.000 tokens de entrada sem cachePreço · 1M de tokens |
|---|---|---|---|---|
| Entrada | $0.80 | $1.60 | $1.00 | $2.00 |
| Saída, incluindo raciocínio | $4.80 | $7.20 | $6.00 | $9.00 |
| Entrada em cache | $0.08 | $0.16 | $0.10 | $0.20 |
Somente a entrada sem cache determina a faixa de preço. A entrada em cache é cobrada separadamente pela tarifa dessa faixa. Os exemplos usam a faixa padrão.
O que é o Gemini 3.1 Pro?
O Gemini 3.1 Pro é um modelo de raciocínio do Google para entender código, comparar documentos e explicar informações em diferentes mídias. Forneça juntos o material, a pergunta e o formato esperado da resposta.
Use gemini-3.1-pro-preview para o Gemini 3.1 Pro comum. O Google também documenta uma variante customtools para seleção especializada de ferramentas. Esta página conecta a versão comum; a profundidade do raciocínio é uma configuração separada.
Limites oficiais do modelo conferidos em 17 de outubro de 2026. Entrada e saída têm limites separados.
Comece com o Gemini 3.1 Pro
Comece com uma tarefa representativa. Salve as entradas e configurações para comparação.
Teste o Playground
Envie uma mensagem ao Gemini 3.1 Pro, anexe material de apoio e examine a requisição JSON nativa antes de enviá-la. Os controles oficiais usam nomes e tipos de campos nativos; o JSON personalizado é enviado sem alterações para validação pela API Gemini.
Escolha o grupo da sua conta
Escolha entre os grupos do Gemini 3.1 Pro disponíveis para sua conta. O Playground atualiza as tarifas conforme sua seleção; grupos adicionais aparecem na mesma lista baseada nas permissões da conta.
Use a referência da API
Copie um exemplo nativo do Gemini 3.1 Pro para seu aplicativo. A referência lista campos de requisição e resposta, entradas de mídia e capacidades que ainda exigem verificação online.
O que o Gemini 3.1 Pro pode ajudar você a criar
Escolha uma especificação de saída e confira o resultado com o material de origem.
Analise uma alteração
Peça ao Gemini 3.1 Pro para rastrear um bug entre funções relacionadas, explicar suas premissas e propor uma correção pontual. Execute seus testes antes de aceitar a alteração.
Retorne dados estruturados
Forneça ao Gemini 3.1 Pro um esquema de resposta JSON para extração ou classificação. Confira os valores retornados com o documento; um JSON válido, por si só, não comprova a exatidão dos fatos.
Trabalhe com suas funções
Declare funções nomeadas e seus esquemas de argumentos. O Gemini 3.1 Pro pode retornar uma chamada de função para seu aplicativo executar; seu código decide quais ações são permitidas.
Compare mídia e texto
Coloque um gráfico, captura de tela ou PDF ao lado da pergunta. O Gemini 3.1 Pro aceita entrada multimodal e retorna texto, sendo útil para explicações fundamentadas no material fornecido.
Tarefas práticas com o Gemini 3.1 Pro
Fluxos de trabalho sugeridos; não se afirma nenhum resultado de benchmark ou de cliente.
Revise uma alteração no repositório
Forneça os arquivos relevantes e a falha do teste ao Gemini 3.1 Pro. Peça a menor alteração que resolva a falha, com uma explicação separada das incertezas restantes.
Extraia uma lista de verificação de um documento
Peça ao Gemini 3.1 Pro para transformar um documento fornecido em uma lista de verificação estruturada. Inclua a localização das fontes no esquema para que um revisor confira cada item extraído.
Explique uma demonstração gravada
Forneça um vídeo curto em formato compatível e peça ao Gemini 3.1 Pro para descrever uma etapa específica. Limite a pergunta às evidências visíveis e peça que identifique detalhes pouco claros.
Como usar o Gemini 3.1 Pro
- 01
Prepare o acesso
Entre na conta, adicione créditos e crie uma chave de API para uso no servidor. Abra o Gemini 3.1 Pro no Playground para examinar o formato da requisição.
- 02
Forneça o contexto
Coloque o prompt e a conversa anterior em contents. Para entrada de mídia no Gemini 3.1 Pro, inclua o tipo MIME correto e uma referência de arquivo compatível.
- 03
Escolha o raciocínio e a saída
Use raciocínio low, medium ou high. O Gemini 3.1 Pro usa high por padrão; defina maxOutputTokens de forma consciente quando o tamanho da resposta importar.
- 04
Confira a resposta
Leia candidates, finishReason e usageMetadata. Preserve as assinaturas de raciocínio e as partes de ferramentas do Gemini 3.1 Pro ao enviar o próximo turno.
A API nativa do Gemini 3.1 Pro
O Gemini 3.1 Pro usa generateContent para respostas JSON e streamGenerateContent para eventos enviados pelo servidor. A referência separada inclui exemplos que você pode copiar e o esquema completo de parâmetros.
Nome exato do modelo
Use gemini-3.1-pro-preview na URL. Um nome de exibição como Gemini 3.1 Pro não substitui o identificador da API.
Configurações explícitas de geração
O Gemini 3.1 Pro mantém temperature e os campos de amostragem. O Google recomenda temperature 1.0. Nível de raciocínio, formato de saída e ferramentas continuam sendo controles distintos.
Leia o uso real
O uso de saída do Gemini 3.1 Pro inclui tokens de raciocínio. A entrada em cache faz parte da entrada total para o limiar de contexto e é cobrada pela tarifa de entrada em cache.
Duas variantes oficiais do Gemini 3.1 Pro
A diferença é a seleção de ferramentas, não um segundo nível de raciocínio. Somente o modelo comum do Gemini 3.1 Pro está conectado nesta página.
| Opção | Preview comum | Preview Customtools |
|---|---|---|
| ID na API | gemini-3.1-pro-preview | gemini-3.1-pro-preview-customtools |
| Finalidade documentada | Raciocínio geral e uso de ferramentas | Priorizar ferramentas personalizadas quando bash também está disponível |
| Chamadas de funções | Compatível | Comportamento especializado de seleção de ferramentas |
| Pergunta para avaliação | Resolve a tarefa real? | Escolhe a ferramenta personalizada pretendida? |
O Google alerta que o Customtools pode apresentar variação de qualidade fora do fluxo de trabalho pretendido. Esta é uma comparação da documentação, não um novo benchmark A/B. Documentação do modelo do Google
Limites do Gemini 3.1 Pro
Orçamentos separados de entrada e saída
O Gemini 3.1 Pro aceita até 1.048.576 tokens de entrada e produz até 65.536 tokens de saída. O raciocínio usa o orçamento de saída; uma resposta curta ainda pode exigir tokens de raciocínio.
Saída somente em texto
O Gemini 3.1 Pro pode analisar mídias compatíveis, mas não gera imagens nem áudio. Use um modelo de geração dedicado para essas saídas.
Verifique capacidades avançadas
O Gemini 3.1 Pro oferece suporte a ferramentas na especificação oficial do modelo. As verificações online de mídia, cache e ferramentas individuais ainda estão pendentes aqui; aceitar um parâmetro não comprova seu comportamento.
Recursos de cache exigem acesso
Um valor de cachedContent identifica um recurso de cache existente. O Gemini 3.1 Pro não pode usar um cache apenas porque seu nome está bem formado; acesso ao recurso e compatibilidade do modelo continuam necessários.
Use o Gemini 3.1 Pro com o SeedRouter
Um único saldo na conta
Use o mesmo saldo do SeedRouter para o Gemini 3.1 Pro e os demais modelos de texto, imagem e vídeo listados. Mantenha o formato de requisição e as restrições de cada modelo.
Preços ao lado do modelo
Confira as tarifas por token do Gemini 3.1 Pro nesta página e selecione o grupo da conta que pretende usar. A tabela de preços acompanha as configurações atuais de cobrança.
Pague por requisições bem-sucedidas
Requisições do Gemini 3.1 Pro que falham não são cobradas. As bem-sucedidas usam o consumo de tokens informado, incluindo raciocínio e entrada em cache.
Explore outros modelos de texto
Compare capacidades documentadas e tarifas atuais dos modelos de texto disponíveis.
Chame o GPT-6 Astra com o SDK da OpenAI. O modelo mais poderoso da OpenAI, com contexto de 1.05M de tokens, preço por token em tempo real e um Playground para testar agora mesmo.
Ver preçosUse o GPT-6 Sol com o SDK da OpenAI: contexto de 1.05M de tokens, esforço de raciocínio de none a max, preço por token em tempo real e um Playground para testar.
Ver preçosUse o GPT-6.1 Sol com o SDK da OpenAI: programação e agentes perto do Astra por um quinto do preço, contexto de 1.05M de tokens e 95% off na entrada em cache.
Ver preçosChame o GPT-6 Luna com o SDK da OpenAI. O modelo GPT-6 mais barato, com contexto de 1.05M de tokens, preços por token em tempo real e um Playground para testar agora mesmo.
Ver preçosTeste Claude Haiku 5.5 para classificar, extrair dados e resumir. Confira preços atuais por token, teste prompts e conecte seu app pela API de Messages.
Ver preçosTeste Claude Sonnet 5.5 com código e documentos. Veja preços atuais, experimente prompts e confira recursos verificados antes de conectar sua aplicação.
Ver preçosGuias do Gemini 3.1 Pro
Entenda os dois IDs oficiais do modelo antes de escolher as configurações do seu aplicativo.
Compare os dois IDs oficiais do Gemini 3.1 Pro, o que muda no Customtools e quando o modelo Preview comum atende ao seu aplicativo.
Compare Gemini 3.8 Flash e Gemini 3.1 Pro por raciocínio padrão, status, limites de tokens e critérios de avaliação. Sem presumir um vencedor universal.
Perguntas frequentes sobre o Gemini 3.1 Pro
Qual ID de modelo do Gemini 3.1 Pro devo usar?+
O Gemini 3.1 Pro usa gemini-3.1-pro-preview aqui. A variante customtools separada prioriza ferramentas personalizadas quando bash também está disponível.
Qual é o nível de raciocínio padrão do Gemini 3.1 Pro?+
O Gemini 3.1 Pro usa high por padrão; low e medium são compatíveis; minimal não é. Não combine thinkingLevel com thinkingBudget.
Por que o preço do Gemini 3.1 Pro muda acima de 200K tokens de entrada?+
As tarifas atuais usam duas faixas; a superior se aplica acima de 200.000 tokens de entrada sem cache. A entrada em cache é cobrada separadamente pela tarifa de entrada em cache da faixa selecionada. Confira a tabela em tempo real para cada grupo da conta.
O Gemini 3.1 Pro pode gerar imagens?+
O Gemini 3.1 Pro aceita mídias compatíveis, mas retorna texto. Use um modelo de imagem quando precisar de uma imagem gerada.
Preciso do Customtools para chamar funções com o Gemini 3.1 Pro?+
O Gemini 3.1 Pro comum oferece suporte à chamada de função. O Customtools altera o comportamento de seleção de ferramentas; ele não é necessário para declarar funções.
Teste o Gemini 3.1 Pro
Comece com um prompt representativo, examine a requisição nativa e confira o resultado com sua tarefa.