Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity
ce4c0930c3
yoi/docs/research/gemini_max_output_tokens.md

2.4 KiB
Raw Blame History

Google Gemini API: maxOutputTokens パラメータ仕様

Source: https://ai.google.dev/api/generate-content
Source (thinking): https://ai.google.dev/gemini-api/docs/thinking
Source (Gemini 2.5 Flash): https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash
Source (Gemini 2.5 Pro): https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro
Retrieved: 2026-04-28

1. パラメータ名と位置

generationConfig.maxOutputTokens

リクエストボディのトップレベルではなく、generationConfig オブジェクト内に配置する。 SDK では GenerateContentConfig(max_output_tokens=...) として渡す。

2. 必須 / 任意

任意 (optional)。省略時はモデルのデフォルト上限が適用される。

3. 型と範囲

  • 型: integer
  • モデル別の最大値:
    • gemini-2.5-flash: 最大 65,536 トークン
    • gemini-2.5-pro: 最大 65,536 トークン
  • 最小値の公式明記はないが、正の整数を指定する。

4. thinking トークンとの関係

  • maxOutputTokens が制限するのは最終レスポンスの出力トークン数のみ。thinking トークンは usageMetadata.thoughtsTokenCount として別途計上され、maxOutputTokens のカウントには含まれない。
  • thinking トークンの制御には generationConfig.thinkingConfig.thinkingBudget を用いる。
    • Gemini 2.5 Flash / Pro: 128〜32768 トークン、0 で thinking 無効化（モデルによる）、-1 で動的
  • 課金は「output tokens + thinking tokens」の合算。
  • maxOutputTokens と thinkingBudget は独立したパラメータであり、両方を同時に指定できる。

注意: 2025年10月時点で gemini-2.5-flash において max_output_tokens が無視されるバグが報告されており、Google 側が修正をロールアウトした経緯がある。最新モデルで想定通りに機能するか実測で確認することを推奨。

5. ドキュメント URL