3 passos para configurar o modo Gemini Thinking: tutorial de configuração completo para Cherry Studio e Chatbox

Quer fazer a IA "pensar antes de responder" como um ser humano? O modo Gemini Thinking é o mais recente recurso de raciocínio profundo lançado pelo Google, permitindo que o modelo mostre todo o seu processo de pensamento antes de entregar a resposta. Este artigo detalha como configurar corretamente o modo Gemini Thinking em dois dos principais clientes de IA: Cherry Studio e Chatbox.

Valor central: Ao ler este artigo, você aprenderá a ativar o modo de pensamento do Gemini no Cherry Studio e no Chatbox, visualizar o processo de raciocínio do modelo e melhorar a eficácia na resolução de tarefas complexas.

Pontos Principais do Modo Gemini Thinking

O modo Gemini Thinking é uma funcionalidade de raciocínio profundo introduzida pelo Google nas séries de modelos Gemini 2.5 e 3. Ao contrário de uma conversa comum, o modo Thinking faz com que o modelo realize um raciocínio interno antes de fornecer a resposta final, aumentando significativamente a precisão em tarefas complexas.

Modelos compatíveis com o Modo Gemini Thinking

Atualmente, os modelos Gemini que suportam o modo Thinking são:

🎯 Sugestão Técnica: No desenvolvimento prático, recomendamos usar a plataforma APIYI (apiyi.com) para chamadas unificadas aos modelos Gemini Thinking. A plataforma oferece interfaces compatíveis com o formato OpenAI, eliminando a necessidade de lidar com processos complexos de autenticação da API do Google.

Detalhes dos Parâmetros da API do Modo Gemini Thinking

Diferentes versões dos modelos Gemini utilizam parâmetros diferentes para controlar o pensamento:

Série Gemini 3 – Parâmetro thinking_level

Série Gemini 2.5 – Parâmetro thinking_budget

Configurando o Modo Gemini Thinking no Cherry Studio

O Cherry Studio é um cliente de IA poderoso que suporta mais de 300 modelos e diversos provedores de IA. Abaixo, detalhamos os passos para configurar o Modo Gemini Thinking no Cherry Studio.

Passo 1: Adicionar o Provedor de API do Gemini

1. Abra o Cherry Studio e vá em Configurações → Provedores
2. Encontre o Gemini ou Provedor Personalizado
3. Insira as informações de configuração da API:

Endereço da API: https://api.apiyi.com/v1
Chave de API: Sua chave da APIYI

💡 Dica de configuração: Use a APIYI (apiyi.com) como endereço da API para obter um acesso mais estável e um formato de interface unificado.

Passo 2: Adicionar os Modelos Gemini Thinking

Clique no botão "Gerenciar" ou "Adicionar" na parte inferior para adicionar manualmente os seguintes modelos:

Passo 3: Ativar a Chave do Thinking Mode

Na interface de chat:

1. Clique no ícone de configurações no canto superior direito
2. Encontre a opção Thinking Mode
3. Mude a chave para ON

Configuração de Parâmetros Personalizados no Cherry Studio

Se a chave na interface (UI) não funcionar, você precisará configurar os parâmetros personalizados manualmente:

Para modelos Gemini 3:

{
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "high",
      "includeThoughts": true
    }
  }
}

Para modelos Gemini 2.5:

{
  "generationConfig": {
    "thinkingConfig": {
      "thinkingBudget": -1,
      "includeThoughts": true
    }
  }
}

Cole a configuração JSON acima na área de Parâmetros Personalizados (Custom Parameters) do Cherry Studio.

🚀 Começo Rápido: Recomendamos usar a plataforma APIYI (apiyi.com) para obter sua Chave de API. Ela suporta toda a linha de modelos Gemini e a configuração é mais simples.

Configurando o modo Gemini Thinking no Chatbox

O Chatbox é outro cliente desktop de IA amplamente popular, com uma interface limpa e suporte para várias plataformas. Veja a seguir como configurar o modo Gemini Thinking no Chatbox.

Passo 1: Configurar o Provedor de API

1. Abra o Chatbox e clique em Configurações no canto inferior esquerdo.
2. Selecione Provedor de Modelo → Custom (Personalizado).
3. Configure as informações da API:

Nome: Gemini Thinking
Tipo de API: OpenAI Compatible
API Host: https://api.apiyi.com
API Key: sk-seu-token-apiyi

Passo 2: Selecionar o Modelo Thinking

No seletor de modelos, digite ou selecione:

• gemini-3-pro-preview – Maior capacidade de raciocínio
• gemini-2.5-pro – Equilíbrio entre desempenho e custo
• gemini-2.5-flash – Resposta rápida

Passo 3: Configurar os Parâmetros de Pensamento

O Chatbox permite configurar o modo de pensamento através de Parâmetros Extras (Extra Parameters):

{
  "thinking_config": {
    "thinking_level": "high"
  }
}

Ou use o thinking_budget:

{
  "thinking_config": {
    "thinking_budget": 8192
  }
}

Configurações de Exibição do Processo de Pensamento no Chatbox

Por padrão, o Chatbox exibe o processo de pensamento de forma recolhida, mas você pode ajustar a exibição:

# Usando o SDK da OpenAI para configurar o Gemini Thinking
import openai

client = openai.OpenAI(
    api_key="sk-seu-token-apiyi",
    base_url="https://api.apiyi.com/v1"  # Interface unificada da APIYI
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[
        {"role": "user", "content": "Por favor, explique por que 1+1=2"}
    ],
    extra_body={
        "thinking_config": {
            "thinking_budget": 8192,
            "include_thoughts": True
        }
    }
)

# Exibe o processo de pensamento e a resposta
print(response.choices[0].message.content)

Melhores Práticas para o Modo Gemini Thinking

Configuração da Profundidade de Pensamento para Diferentes Cenários

Sugestões de Orçamento de Tokens para Pensamento (Thinking Tokens)

Perguntas simples: 0-1024 tokens
Raciocínio geral: 1024-4096 tokens
Tarefas complexas: 4096-16384 tokens
Raciocínio extremo: 16384-32768 tokens

💡 Dica de Escolha: A profundidade de pensamento depende principalmente da complexidade da tarefa. Recomendamos realizar testes práticos na plataforma APIYI (apiyi.com) para encontrar a configuração ideal para o seu caso. A plataforma suporta todos os modelos Gemini Thinking, facilitando a comparação rápida de resultados.

Orçamento de Thinking Tokens e Complexidade da Tarefa Escolha a profundidade de pensamento adequada com base no tipo de tarefa

Complexidade da Tarefa

Orçamento de Thinking Tokens

0 1K 8K 16K 32K

Perguntas simples 0 – 1.024 tokens

<!-- 示例任务 -->
<rect x="105" y="100" width="150" height="70" rx="6" fill="#1e293b" stroke="#22c55e" stroke-width="1" />
<text x="180" y="120" text-anchor="middle" fill="#22c55e" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Tarefas aplicáveis</text>
<text x="115" y="140" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Tradução simples</text>
<text x="115" y="155" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Busca de informações</text>

<!-- 连接线 -->
<line x1="180" y1="170" x2="180" y2="280" stroke="#22c55e" stroke-width="1" stroke-dasharray="4,4" opacity="0.5" />

Raciocínio geral 1K – 4K tokens

<!-- 示例任务 -->
<rect x="260" y="100" width="155" height="70" rx="6" fill="#1e293b" stroke="#3b82f6" stroke-width="1" />
<text x="337" y="120" text-anchor="middle" fill="#3b82f6" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Tarefas aplicáveis</text>
<text x="270" y="140" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Explicação de código</text>
<text x="270" y="155" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Resumo de artigos</text>

<!-- 连接线 -->
<line x1="337" y1="170" x2="337" y2="230" stroke="#3b82f6" stroke-width="1" stroke-dasharray="4,4" opacity="0.5" />

Tarefas complexas 4K – 16K tokens

<!-- 示例任务 -->
<rect x="420" y="100" width="155" height="60" rx="6" fill="#1e293b" stroke="#f59e0b" stroke-width="1" />
<text x="497" y="118" text-anchor="middle" fill="#f59e0b" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Tarefas aplicáveis</text>
<text x="430" y="136" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Algoritmos • Depuração</text>
<text x="430" y="151" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Comparação • Arquitetura</text>

<!-- 连接线 -->
<line x1="497" y1="160" x2="497" y2="170" stroke="#f59e0b" stroke-width="1" stroke-dasharray="4,4" opacity="0.5" />

Raciocínio extremo 16K – 32K tokens

<!-- 示例任务 -->
<rect x="580" y="175" width="155" height="60" rx="6" fill="#1e293b" stroke="#ef4444" stroke-width="1" />
<text x="657" y="193" text-anchor="middle" fill="#ef4444" font-size="11" font-weight="bold" font-family="system-ui, sans-serif">Tarefas aplicáveis</text>
<text x="590" y="211" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Provas matemáticas • Programação complexa</text>
<text x="590" y="226" fill="#e2e8f0" font-size="9" font-family="system-ui, sans-serif">• Raciocínio profundo • Planejamento estratégico</text>

💡 Recomendação: use thinking_budget: -1 (modo dinâmico) para o modelo ajustar automaticamente a profundidade

Comparação: Modo Thinking vs. Modo Comum

Perguntas Frequentes

{
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "high",
      "includeThoughts": true
    }
  }
}

Resumo

O modo Gemini Thinking é uma funcionalidade poderosa para elevar a capacidade de raciocínio do seu Modelo de Linguagem Grande. Através deste tutorial de configuração, você aprendeu:

1. Entender os princípios do modo Thinking: Dominar a diferença entre os parâmetros thinking_level e thinking_budget.
2. Métodos de configuração no Cherry Studio: Ativar o modo de pensamento via interface ou parâmetros JSON personalizados.
3. Métodos de configuração no Chatbox: Utilizar os "Extra Parameters" para configurar os parâmetros de pensamento.
4. Melhores Práticas: Escolher a profundidade de pensamento adequada de acordo com a complexidade da tarefa.

Recomendamos utilizar a APIYI (apiyi.com) para validar rapidamente os efeitos do modo Gemini Thinking. A plataforma oferece uma interface unificada compatível com OpenAI, suporte para todas as séries de modelos Gemini 2.5 e 3, com configuração simplificada e acesso mais estável.

Referências

1. Documentação oficial do Google Gemini Thinking: Descrição completa dos parâmetros da API

   • Link: ai.google.dev/gemini-api/docs/thinking

2. Documentação oficial do Cherry Studio: Guia de configuração do cliente

   • Link: docs.cherry-ai.com

3. Lista de modelos Gemini: Lista de modelos compatíveis com o Thinking

   • Link: ai.google.dev/gemini-api/docs/models

Autor: Equipe APIYI
Suporte Técnico: Para obter a API do Gemini ou consultoria técnica, acesse APIYI em apiyi.com