Google/gemini-3.1-pro-preview

谷歌最强推理模型

OperacionalChat & ReasoningCodingAdvanced ReasoningEntrada $0.70/1MSaída $0.70/1M-65%vs. oficialUso comercialPrivacidade de dados

Entrada

Saída

Envie uma mensagem à esquerda. A resposta aparece aqui.

Preços

Este modelo é cobrado pelas dimensões de uso listadas aqui. Comparar todos os preços.

Preços de tabela em USD. Seu preço efetivo também depende do grupo de faturamento da sua chave de API.

CritérioEntradagemini-3.1-pro-preview
$0.70por 1 M2/1M
CritérioSaídagemini-3.1-pro-preview
$0.70por 1 M2/1M

API

POST/v1beta/models/gemini-3.1-pro-preview:generateContent
const BASE_URL = "https://api.dreamtoai.com";
const API_KEY = process.env.MIX_API_KEY;

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

const payload = {
  "model": "gemini-3.1-pro-preview",
  "messages": [
    {
      "content": "你好,世界",
      "role": "user"
    }
  ],
  "system_instruction": "你是一个严谨的助手。",
  "temperature": 0.7,
  "top_p": 1,
  "max_tokens": 4096,
  "stream": false,
  "top_k": 40,
  "reasoning_effort": "low",
  "response_modalities": [
    "TEXT"
  ],
  "tools": []
};

const submit = await fetch(`${BASE_URL}/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
}).then((r) => r.json());

const status = await fetch(`${BASE_URL}/v1/jobs/${submit.id}`, { headers })
  .then((r) => r.json());
console.log(status);

Crie uma chave em Console → Chaves de API e substitua o espaço reservado no exemplo.

README

gemini-3.1-pro-preview

谷歌最强推理模型

Por que escolher?

Linguagem e raciocínio
Escrita, análise, programação e conversa em vários turnos em um só modelo.
Pague por token
$0.70 por 1M de tokens de entrada e $0.70 por 1M de tokens de saída, sem assinatura.
Funciona com seu SDK
Chame no formato Gemini / OpenAI Chat Completions: clientes existentes só precisam de uma nova URL base e chave.
Uma chave para todos os modelos
A mesma chave de API funciona para todos os modelos da dreamtoai.

Parâmetros

ParâmetroObrigatórioDescrição
messagesarrayObrigatórioHistórico da conversa como uma lista de mensagens com role e content.
system_instructionstringOpcionalInstruções que definem o comportamento do assistente.
temperaturenumberOpcionalTemperatura de amostragem. Mais baixa é mais focada; mais alta, mais variada. Padrão: 0.7.
top_pnumberOpcionalLimite de amostragem nucleus. Padrão: 1.
max_tokensintegerOpcionalNúmero máximo de tokens a gerar.
streambooleanOpcionalTransmite a resposta como server-sent events. Padrão: false.
top_kintegerOpcionalTop K
reasoning_effortenumOpcional推理强度 Opções: low, medium, high. Padrão: medium.
response_modalitiesarrayOpcional响应模态
toolsarrayOpcional工具列表

Como usar

  1. Teste aqui primeiro — Entre e rode o modelo no playground acima para conferir o resultado antes de escrever código.
  2. Crie uma chave de API — Abra Console → Chaves de API e crie uma chave. A mesma chave funciona para todos os modelos.
  3. Escreva suas mensagens — Coloque a tarefa e o contexto no array messages; adicione um prompt de sistema para definir o comportamento do assistente.
  4. Defina os parâmetros opcionais — Ajuste os parâmetros opcionais listados acima para controlar a saída.
  5. Envie a requisição — Chame POST /v1beta/models/gemini-3.1-pro-preview:generateContent com o ID de modelo gemini-3.1-pro-preview.
  6. Leia a resposta — A resposta e o uso de tokens voltam no retorno e ficam registrados no console.

Como escrever prompts eficazes

Instruções claras geram respostas melhores. Diga ao modelo quem ele é, o que você precisa e como a resposta deve ser.

1. Defina o papel e o objetivo

Comece dizendo quem o modelo deve ser e qual é a tarefa. Regras que nunca mudam vão no prompt de sistema.

Você é um revisor sênior de Python. Revise a função abaixo em busca de bugs e problemas de legibilidade.

2. Dê o contexto

Cole aquilo de que a resposta depende: documentos, código, dados ou decisões anteriores. Separe cada parte com um título ou tag.

3. Especifique a saída

Diga o formato, o tamanho e o tom: uma tabela, JSON com chaves definidas, cinco tópicos, um resumo de 200 palavras.

4. Mostre um exemplo

Um ou dois exemplos de entrada e saída definem o estilo mais rápido do que uma descrição longa.

5. Itere

Quando a resposta erra, adicione a restrição que falta ao prompt em vez de recomeçar.

Prompt
FracoEscreva sobre nosso produto.
ForteVocê é redator B2B. Escreva três posts de 40 palavras para o LinkedIn anunciando nossa API de faturamento para pequenos escritórios de contabilidade. Tom: confiante, linguagem simples, sem emojis. Termine cada post com uma pergunta.

Preços

Item cobradoPreçoPreço oficial
Entrada$0.70 por 1 M$2.00/1M
Saída$0.70 por 1 M$2.00/1M

Isso é 65% abaixo do preço oficial de tabela.

Exemplo: uma requisição com 10.000 tokens de entrada e 1.000 de saída custa cerca de $0.0077.

Preços de tabela em USD. Seu preço efetivo também depende do grupo de faturamento da sua chave de API. Comparar todos os preços

Melhores casos de uso

  • Assistentes de programação — Gere, revise e refatore código, ou explique uma base de código desconhecida.
  • Agentes e automação — Planeje tarefas em várias etapas e chame ferramentas a partir dos seus fluxos.
  • Trabalho intelectual — Resuma relatórios, rascunhe documentos e responda perguntas sobre seu próprio conteúdo.
  • Atendimento ao cliente — Alimente bots de suporte e rascunhe respostas com tom consistente.
  • Extração de dados — Transforme texto não estruturado em JSON estruturado para outros sistemas.
  • Tradução e localização — Traduza e adapte textos entre idiomas.

Dicas avançadas

  • Coloque instruções estáveis no prompt de sistema e deixe as mensagens do usuário para a tarefa em si.
  • Defina max_tokens para limitar o tamanho e o custo de cada resposta.
  • Peça JSON com as chaves exatas quando um programa for ler a resposta.
  • Teste prompts no playground acima antes de integrá-los ao código.
  • Acompanhe o uso de tokens no console para identificar prompts caros demais.

Ver todos os LLMsExplorar o API Market

FAQ

O que é gemini-3.1-pro-preview?

谷歌最强推理模型

Como chamo a API do gemini-3.1-pro-preview?

Envie POST /v1beta/models/gemini-3.1-pro-preview:generateContent com o ID de modelo gemini-3.1-pro-preview e sua chave de API. Há exemplos prontos para rodar na seção API acima.

Como a cobrança é calculada?

As solicitações são cobradas pelos preços acima e debitadas da sua carteira. O custo final depende do uso e do grupo de faturamento vinculado à sua chave de API.

Onde consigo uma chave de API?

Crie em Console → Chaves de API. A mesma chave funciona para todos os modelos do gateway.

Posso usar o resultado comercialmente?

Sim. Você pode usar o que gerar em projetos comerciais, sujeito aos termos do provedor do modelo.

Sobre gemini-3.1-pro-preview na dreamtoai

谷歌最强推理模型

Modelos relacionados

Próximos passos