【日次ログ】Geminiのサンプリング設定が非推奨に ― APIエラーと移行時の確認

2026-09-05 精査・訂正
初稿の「Google側は挙動が不安定になるだけで動作自体は止まらない」は、公式資料から保証できないため撤回します。現行の移行手順と、Claude側のAPI・SDKの条件を補足しました。今回は資料の照合であり、実際のAPIへの送信やエラー再現は行っていません。
2026-11-15 Claude API・SDK条件を追記
Claude API version
2026-10-21とPython SDK v1の移行資料を追加確認しました。現行API versionでrequestへ3パラメータを含めた場合のHTTP 400と、Python SDK v1の直接keywordが送信前に起こすTypeErrorを分けました。実APIへの送信は行っていません。
7月21日の告知と、9月5日の移行ガイドを分ける
Gemini APIの変更履歴には、2026年7月21日付でtemperature・top_p・top_kの非推奨化が記載されています。同じ日の項目にGemini 3.6 Flashと3.5 Flash-Liteの一般提供も載っています。
プロンプト戦略ガイドには、パラメータを変更できるものの、Gemini 3.xでは既定値の維持を強く勧める注記があります。変更によってループや性能低下が起こり得るという説明です。これは、どのモデル・API・SDKでも指定が受理されるという保証ではありません。
さらに、変更履歴からリンクされている最新モデルのガイドを9月5日に開くと、対象はGemini 3.8 Flashでした。その移行チェックリストには、この3パラメータを生成設定から取り除く手順が載っています。7月の告知と、随時変わる「最新モデル」ページの現在の説明を同じ時点の情報として扱わないようにします。
したがって、初稿のようにGoogleを「警告だけ」、Anthropicを「必ず停止」と単純に二分する説明は不適切でした。移行先のモデルIDと利用APIを確定し、その時点の対象モデルの手順で確認する必要があります。
Claude側でも、API versionとSDKで失敗する場所が違う
11月15日にAPI version 2026-10-21の移行資料、パラメータ非推奨ページ、Python SDK v1移行資料を照合しました。3パラメータの条件は、利用するAPI versionとSDKで分ける必要があります。
| 確認する層 | 公式資料にある条件 |
|---|---|
API version 2026-10-21 |
modelや値に関係なく、temperature・top_p・top_kのいずれかをrequestへ含めると400。既定値を明示した場合も含む |
| 従来のAPI version | Claude 4.7以降とMythos Previewで、3パラメータに既定値以外を指定すると400 |
| Python SDK v1 | 3パラメータは直接keywordから取り除かれ、渡すと送信前にTypeError |
| 推奨される対応 | 対象パラメータを省略し、振る舞いはプロンプトで誘導 |
Python SDK v1の移行資料は、従来のAPI versionで旧modelを使う場合にextra_bodyへ移す例も示しています。しかし、API version 2026-10-21ではrequestに含めること自体が400の条件です。extra_bodyなら現行API versionでも通る、という回避策にはできません。
SDKの直接keywordでTypeErrorとなり送信に至らない場合と、requestが送信されてHTTP 400となる場合では、確認する記録も異なります。また、すべての言語のSDKがPython SDK v1と同じ送信前検査を行うとは書かれていません。どちらも「モデルを最新版へ変えた瞬間に必ずパイプライン全体が停止する」とまでは断定できず、アプリ側の例外処理や再試行の設計も関係します。
実務では、検索した範囲と送信内容を区別する
初稿には、リポジトリの文字列検索で指定が見当たらなかったため「未使用」と書いていました。しかし、検索対象・除外範囲・利用SDKを記録していない検索だけでは、処理全体で未使用だとは証明できません。今回、その断定も取り下げます。
これから自分の処理を点検する場合は、以下を一組で残すと、モデルを替えたときに比較しやすくなります。当ブログで整理した点検票であり、特定の環境に対する実行済みの結果ではありません。
| 点検項目 | 記録すること |
|---|---|
| 呼び出し先 | 事業者、モデルID、利用API、SDK名と版 |
| 設定の所在 | 自作コード、共通設定、利用ライブラリ。検索した範囲と除外した範囲 |
| 実際のリクエスト | 3パラメータが含まれるか。鍵や業務データは記録から除く |
| 失敗の場所 | 送信前の例外か、HTTP応答か、正常応答後の出力検査か |
| 比較結果 | 同じ非機密入力で、変更前後の出力と後続処理の結果 |
文字列検索にはtopP・topKなどの表記違いもあり得ます。見つかった文字列が説明文なのか、実際の設定なのかも読み分けます。検索結果だけで設定を一括削除せず、移行先が使う設定と対象外の処理を区別してください。
出力形式を指定しても、内容の正しさは別に検査する
プロンプトで出力形式を明示したり構造化出力を使ったりすることは、入力パラメータが受理されるかという問題とは別の対策です。Googleの構造化出力ガイドも、JSONとして正しい出力であっても、値の検証と意味的に誤った出力への対処をアプリ側で行うよう案内しています。
例えば「金額を数値で返す」という形式が守られていても、抽出した金額や通貨が元データと一致するとは限りません。形式の検査、元データとの照合、後続処理への入力可否を分けて判定します。これはパラメータを省略しただけで不要になる検査ではありません。
今回の限界と次の行動
今回確認したのは公式7ページの記載です。API version 2026-10-21のHTTP 400、従来versionの条件、Python SDK v1のTypeError、extra_bodyを含む移行方法は資料上の確認であり、実APIでは再現していません。パラメータ変更による品質差や費用差も実測していません。他の言語のSDK、他の事業者、すべてのGemini旧モデルへ同じ条件を一般化しません。
モデル変更前には、まず現在のモデルID・API・SDK版を記録します。次に該当する移行ガイドを読み、非機密の小さな入力で変更前後を比較してください。「非推奨」と聞いて一括削除するのでも、「まだ動くはず」と放置するのでもなく、設定の受理と出力の品質を別々に確認するのが、この記録からの次の行動です。