はじめに
2026年5月25日、Google は Gemini API の gemini-3.1-flash-lite-preview モデルをシャットダウンしました。
プレビュー版は「試験運用中の機能を試したい」というユーザー向けに提供されていましたが、安定版 gemini-3.1-flash-lite が正式リリースされた今、役目を終えた形です。
⚠️ Breaking Change
gemini-3.1-flash-lite-previewを指定したコードは現時点で動作しません。速やかに安定版モデルへ置き換えが必要です。
この記事では、影響を受ける人・具体的な対応手順・移行前後のコード例を解説します。
変更の全体像
プレビュー版から安定版への移行はモデル名の文字列を1か所変えるだけです。ただし、発見が遅れると本番障害に直結するため、早急な対応が求められます。
📌 影響を受ける人
gemini-3.1-flash-lite-previewをモデルIDとして直接指定しているコード・設定ファイルを持つ開発者- Gemini API を使うプロダクト・バッチ処理・社内ツールの運用者
.envや設定ファイルにモデル名をハードコードしている人
変更内容
| 項目 | 変更前 | 変更後 |
|---|---|---|
| モデルID | gemini-3.1-flash-lite-preview |
gemini-3.1-flash-lite |
| ステータス | Preview（試験運用） | GA（一般提供・安定版） |
| シャットダウン日 | — | 2026年5月25日 |
| APIエンドポイント | Gemini API | Gemini API（同じ） |
| 呼び出し方法 | 変更なし | 変更なし |
変更はモデル名の識別子のみです。APIのリクエスト構造・レスポンス形式・認証方法は変わりません。
影響と対応
影響の深刻度
プレビュー版モデルを指定したリクエストを送ると、APIはモデルが存在しないとしてエラーを返します。無通告でのシャットダウンではなく、リリースノートで告知済みですが、見落としていた場合は本番障害に発展します。
対応フロー
確認コマンド（grep でまとめて検出）
# プロジェクト内の全ファイルからプレビュー版モデル名を検索
grep -r "gemini-3.1-flash-lite-preview" . --include="*.py" --include="*.ts" --include="*.js" --include="*.env" --include="*.yaml" --include="*.json"
コード例
Python（google-generativeai）
Before:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
# ❌ シャットダウン済みモデル
model = genai.GenerativeModel("gemini-3.1-flash-lite-preview")
response = model.generate_content("日本の首都はどこですか？")
print(response.text)
After:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
# ✅ 安定版モデルに変更
model = genai.GenerativeModel("gemini-3.1-flash-lite")
response = model.generate_content("日本の首都はどこですか？")
print(response.text)
Node.js（@google/generative-ai）
Before:
import { GoogleGenerativeAI } from "@google/generative-ai";
const genAI = new GoogleGenerativeAI(process.env.API_KEY!);
// ❌ シャットダウン済みモデル
const model = genAI.getGenerativeModel({ model: "gemini-3.1-flash-lite-preview" });
const result = await model.generateContent("日本の首都はどこですか？");
console.log(result.response.text());
After:
import { GoogleGenerativeAI } from "@google/generative-ai";
const genAI = new GoogleGenerativeAI(process.env.API_KEY!);
// ✅ 安定版モデルに変更
const model = genAI.getGenerativeModel({ model: "gemini-3.1-flash-lite" });
const result = await model.generateContent("日本の首都はどこですか？");
console.log(result.response.text());
環境変数で管理している場合
モデル名をコードにハードコードせず、環境変数で管理しているプロジェクトでは .env ファイルの修正だけで対応できます。
Before (.env):
GEMINI_MODEL=gemini-3.1-flash-lite-preview
After (.env):
GEMINI_MODEL=gemini-3.1-flash-lite
💡 Tips
モデル名を環境変数や設定ファイルで一元管理するパターンにしておくと、今後のモデル切り替え時もコード変更なしで対応できます。特に複数のサービスや Lambda 関数で同じモデルを使っている場合は効果的です。
まとめ
| ポイント | 内容 |
|---|---|
| 対象モデル | gemini-3.1-flash-lite-preview |
| シャットダウン日 | 2026年5月25日 |
| 移行先 |
gemini-3.1-flash-lite（安定版） |
| 移行コスト | 低（モデルIDの文字列変更のみ） |
| 対応期限 | 即時（すでにシャットダウン済み） |
変更内容はシンプルですが、見落とすと本番障害に直結する破壊的変更です。grep でプロジェクト全体を検索し、プレビュー版の文字列が残っていないか確認してください。
Gemini API のリリースノートは定期的にチェックする習慣をつけておくと、今後の同様の変更にも素早く対応できます。