Gemini Reasoning Models — Thinking & Deep Think
Gemini Reasoning Models
Configurable Reasoning in Gemini
Starting with Gemini 2.0 and refined in 3.x, Gemini models support a thinking_level parameter that controls how much internal reasoning (chain-of-thought) the model performs before answering. This allows developers to calibrate between speed/cost and reasoning depth.
ThinkingConfig on Gemini 4 Argon & Gemini 3.8 Flash
The ThinkingConfig object controls reasoning behavior via the thinking_level parameter:
| Level | Behavior | Best For |
|---|---|---|
| LOW | Minimal internal reasoning, fastest response | Simple lookups, classification, quick answers |
| MEDIUM | Balanced reasoning depth (Default for Gemini 4 Argon & 3.8 Flash) | Standard coding, analysis, summarization |
| HIGH | Maximum reasoning, longest latency | Complex math, multi-step logic, architectural research |
thinking_level="MINIMAL" is not available on gemini-4-argon or gemini-3.8-flash (though gemini-3.6-flash supports minimal). On Argon and 3.8 Flash, supported values are LOW, MEDIUM (default), and HIGH; furthermore, gemini-4-argon supports Long Decode up to 1,048,576 (1M) output tokens.
from google import genai
from google.genai import types
client = genai.Client(vertexai=True, project="my-gcp-project", location="global")
# Use LOW thinking for fast classification
fast_response = client.models.generate_content(
model="gemini-3.8-flash",
contents="Classify this email as spam or not spam: 'You won a prize!'",
config=types.GenerateContentConfig(thinking_config=types.ThinkingConfig(thinking_level="LOW"))
)
# Use HIGH thinking for complex reasoning
deep_response = client.models.generate_content(
model="gemini-3.8-flash",
contents="Prove that there are infinitely many prime numbers.",
config=types.GenerateContentConfig(thinking_config=types.ThinkingConfig(thinking_level="HIGH"))
)Deep Think
Deep Think is a feature of Gemini reasoning models that significantly extends the model's internal chain-of-thought for the most complex tasks - mathematical proofs, multi-file code refactoring, scientific analysis. Deep Think automatically engages when thinking_level is set to HIGH on capable models.
Thought Token Metering
Thinking tokens (the model's internal reasoning) are billed as output tokens. When using HIGH thinking, the model may generate thousands of internal tokens before producing a visible answer. Monitor your usage carefully - setting thinking_level appropriately per task is essential for cost control.
Submit a complex combinatorial logic problem to Gemini 4 Argon / Gemini 3.8 Flash with an explicit HIGH thinkingConfig.