はじめに

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 のリリースノートは定期的にチェックする習慣をつけておくと、今後の同様の変更にも素早く対応できます。