Skip to content

docs(vertex): document reasoning_effort -> thinking_level mapping for Gemini 3.x (#267)#509

Open
Anai-Guo wants to merge 1 commit into
BerriAI:mainfrom
Anai-Guo:docs-vertex-gemini3-reasoning-effort
Open

docs(vertex): document reasoning_effort -> thinking_level mapping for Gemini 3.x (#267)#509
Anai-Guo wants to merge 1 commit into
BerriAI:mainfrom
Anai-Guo:docs-vertex-gemini3-reasoning-effort

Conversation

@Anai-Guo

@Anai-Guo Anai-Guo commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

What

Documents the reasoning_effortthinking_level mapping used for Gemini 3.x models on Vertex AI, closing #267.

The existing "Thinking / reasoning_content" section only covers the older reasoning_effortthinkingBudget (token-budget) mapping. Since then, LiteLLM added a separate reasoning_effortthinkingLevel path for Gemini 3+ models (_map_reasoning_effort_to_thinking_level), so the docs were out of sync with the implementation.

Details

The new table mirrors the current logic in vertex_and_google_ai_studio_gemini.py:

  • Gemini 3.x *-flash models support the minimal thinking level; other Gemini 3+ models floor to low.
  • gemini-3.1-pro-preview maps mediummedium, whereas other non-flash Gemini 3+ models (e.g. gemini-3-pro) map mediumhigh.
  • All levels are sent with includeThoughts: true, except disable/none, which set includeThoughts: false (Gemini 3 cannot fully disable thinking, so the lowest level is used with thoughts hidden).

Docs-only change; no code touched. The older thinkingBudget table is left unchanged.

Closes #267

🤖 Generated with Claude Code

… Gemini 3.x

The Vertex AI Thinking section only covered the reasoning_effort ->
thinkingBudget mapping used by older Gemini models. Gemini 3+ models map
reasoning_effort to a thinkingLevel instead (see _map_reasoning_effort_to_thinking_level),
with model-dependent results. Add a table for the Gemini 3.x thinking-level
mapping so the docs match the current implementation.

Closes BerriAI#267
@vercel

vercel Bot commented Jul 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview, Comment Jul 8, 2026 7:26am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Reflect the current mapping logic of reasoning effort for Gemini in Vertex AI

1 participant