Gemini のパラメーターとプロトコルの違い

互換プロトコルにおける Gemini のパラメーターの違いと使い方を確認します。

Gemini の思考、ツール、キャッシュを本ページで調整してください。完全な構造は Generate Content、Stream Generate Content、Chat Completions を参照。通常とストリーミングは下記を共有します。

対象モデル

モデル	利用上の要点
gemini-4-argon	ネイティブ深度は `LOW/MEDIUM/HIGH`、既定値 `MEDIUM`。暗黙キャッシュのみ。長い出力は継続処理を使用
gemini-3.8-flash	同じ三深度で既定値 `MEDIUM`。ネイティブ `MINIMAL` は非対応。暗黙・明示キャッシュ対応
gemini-3.7-flash	同じ三深度で既定値 `MEDIUM`。ネイティブ `MINIMAL` は非対応。Google Developer API は非推奨として 3.8 へ移行。Google 側の扱いであり、プラットフォーム終了や自動置換を意味しない

Generate Content の差分

フィールド	差分の説明
`thinkingConfig.thinkingLevel`	三モデルとも `MINIMAL` や旧ゼロ予算では思考無効にできない。深度を下げるには `LOW`。Gemini 2.5 の切替を転用しない
`thinkingConfig.thinkingBudget`	新規接続は `thinkingLevel` を使用し、両フィールドの併用は不可。Argon の Developer API は旧予算だけの指定を近い深度へ変換して警告
`temperature/topP/topK`	旧サンプリング設定は無視。指定不要で、これらによる調整は不可
`candidateCount`	Gemini 3 以降は非対応。リクエストから除去
`frequencyPenalty/presencePenalty`	Google Cloud 3.7 Flash ガイドは指定時エラーと明記。上の黙って無視する動作とは異なる
`thinkingConfig.includeThoughts`	有効時は `parts[].thought` で思考要約と回答を区別。要約は元思考でも署名の代替でもない
`parts[].thoughtSignature`	返された Parts を全体・元のまま保持。ツール履歴の署名は必須。署名あり／なしブロックを結合しない
`functionCall/functionResponse`	関数結果の `id` と `name` を実際の呼び出しに一対一で対応させ、並列結果も欠落・誤対応させない
model プリフィル	未完了の model で終わらせない。3.8 は最終 user ターンに空でない文字も必要
`maxOutputTokens`	思考と回答を含む。Argon 直接 REST は非ストリーミング一段 `32768`、ストリーミング一段 `65536`。超過分は継続が必要で、数値を増やすだけで一度に返らない
`continuationToken`	本ページの長出力継続は Argon のみ。`CONTINUATION` は元入力・ツール・総予算を保ち最新トークンを送る。`MAX_TOKENS` 後は既使用 Token より予算を増やす。途中出力を `contents` に追加しない

Chat Completions の差分

以下は Google 公式 Chat 互換層の規則で、全プラットフォームチャネルが同じ変換を使うとは限りません。

フィールド	差分の説明
`reasoning_effort`	対象は `low/medium/high`、既定値 `medium`。Argon は `minimal` も受け付け `low` に変換
`extra_body.google.thinking_config`	`thinking_level`、`include_thoughts` など Gemini 思考設定を渡す。`reasoning_effort` と併用不可
`tool_calls[].extra_content`	`google.thought_signature` と全ツール履歴を保持して再送。名前と引数だけでは署名が失われる
`response_format`	公式対応の JSON 構造化出力を使用。Schema は Gemini のサブセットで、OpenAI の全動作を保証しない。ネイティブ設定は Generate Content Reference
長い出力の継続	Google 公式 Chat 互換入口は長出力継続に非対応。ネイティブ Generate Content または Stream Generate Content を使用

キャッシュの差分

フィールド	差分の説明
暗黙キャッシュ	既定で有効、追加スイッチ不要。Argon と 3.8 Flash は最低入力 `4096` Token と一致が必要で、ヒット保証なし
`cachedContent`	Argon の明示キャッシュ作成・参照はエラー。3.8 Flash は対応。Google Cloud の 3.7 Flash も対応
Chat のキャッシュ参照	Google 互換層は `extra_body.google.cached_content` でネイティブキャッシュを参照し、OpenAI の `prompt_cache_options` は使わない。Chat にしても Argon の明示キャッシュは有効にならない
キャッシュ使用量	ネイティブ `usageMetadata.cachedContentTokenCount` の実際の使用量で確認し、設定有効だけで判断しない

メディア入力の差分

入力	プロトコルのブロック	差分の説明
画像	ネイティブ `inlineData`	Base64 と正しい `mimeType` を指定
ファイル	ネイティブ `fileData`	画像、音声、動画、PDF に使用。サーバーが読める URI を指定し、ローカルパスは不可。提供元 Files 参照は対応サービス由来が必要
画像	Chat `image_url`	公式対応の画像 URL または Base64 Data URL。ネイティブ Parts を転用しない
音声	Chat `input_audio`	公式例は Base64 音声と `format` を使用。音声生成設定ではない

フィールド	差分の説明
`mediaResolution`	入力メディアの処理精度を制御。リクエストと Part は別構造で、個別設定は全体設定を上書き可能。出力画像解像度ではない
`responseModalities`	三モデルの出力は文字のみで `TEXT` を使用。一般 Schema の `IMAGE/AUDIO`、`imageConfig`、`speechConfig` は画像・音声生成に使用しない

呼び出し例

MODEL_ID を完全なモデル ID に置換してください。両例は中深度と明示予算を使用し、自動継続はしません。

curl 'https://api.agtcloud.ai/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "contents": [{"role": "user", "parts": [{"text": "API のタイムアウトの調査方法を三点で説明してください"}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "MEDIUM"},
      "maxOutputTokens": 32768
    }
  }'