Gemini の思考設定

このページでは、Gemini モデルの思考のデフォルト値と調整方法を説明します。モデル ID とエンドポイントの URL は Gemini シリーズの概要を参照してください。

ポイントFlash-Lite 以外の Gemini モデルはデフォルトで思考が有効で、複雑な質問では 1 分以上かかる場合があります。速度を重視する場合は思考量を減らしてください。

Gemini モデルは回答の前に思考を行います。思考で消費したトークンは出力に含まれ、出力単価で課金されます。トークン数は usageMetadata.thoughtsTokenCount（OpenAI 互換 API では usage.completion_tokens_details.reasoning_tokens）で確認できます。

モデル	デフォルト	調整方法
Gemini 3.x（Flash-Lite を除く）	思考あり	`thinkingLevel`（例：`"low"`）。`thinkingBudget`（思考トークンの上限）も可
Flash-Lite シリーズ（3.5、3.1）	思考なし	`thinkingLevel` または `thinkingBudget` を渡すと有効になる

実測では、同じ数学の問題で thinkingLevel: "low" を指定すると、Gemini 3.5 Flash の思考トークンが約 6000 から約 4600 に減り、所要時間もそれに応じて短くなりました。thinkingBudget: 0 を渡すと 3.5 Flash と 3 Flash Preview の思考を無効にできます。3.1 Pro Preview と 3.8 Flash は渡しても思考を行い、完全には無効にできません。

Python（google-genai）

gemini_thinking.py


import os
from google import genai
from google.genai import types
 
client = genai.Client(
    api_key=os.environ["OFOX_API_KEY"],
    http_options={"api_version": "v1beta", "base_url": "https://api.ofox.io/gemini"},
)
 
resp = client.models.generate_content(
    model="google/gemini-3.8-flash",
    contents="n² + n + 41 が素数にならない 50 未満の正の整数 n をすべて求めてください。",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_level="low"),
    ),
)
print(resp.text)
print("思考トークン:", resp.usage_metadata.thoughts_token_count or 0)

cURL

Terminal


curl "https://api.ofox.io/gemini/v1beta/models/google/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "n² + n + 41 が素数にならない 50 未満の正の整数 n をすべて求めてください。"}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "low"}
    }
  }'

Python（OpenAI SDK）

gemini_thinking_openai.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="google/gemini-3.8-flash",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "n² + n + 41 が素数にならない 50 未満の正の整数 n をすべて求めてください。"}],
)
print(resp.choices[0].message.content)
details = resp.usage.completion_tokens_details
print("思考トークン:", details.reasoning_tokens if details else 0)

thinkingLevel: "low" の場合、簡単な質問ではモデルが思考を行わず、thoughtsTokenCount が現れないことがあります。
思考過程を確認したい場合は、thinkingConfig に "includeThoughts": true を追加します。parts のうち "thought": true が付いた要素が思考サマリー、それ以外が回答です。
思考トークンは maxOutputTokens に含まれます。上限が小さすぎると回答が途中で切れます。よくあるエラーを参照してください。
thinkingConfig は generationConfig の中に置きます。