◉ANTIGRAVITY LABEN
記事一覧/連携・プラグイン
⬡ 連携・プラグイン/2026-10-07中級

画像モデルの「10月29日」は表から消えていました — 期限を台帳で追い直し、呼び出し箇所を洗い出す

Gemini API の deprecations 表を11月3日に開き直すと、画像モデル gemini-3.1-flash-image の終了日 10月29日は消え、いま期限が付いているのは gemini-2.5-flash-image(2027年3月15日)でした。表の読み直し、リポジトリ内の呼び出し箇所の洗い出し、戻り先つきの切り替えまでを動くスクリプトで残します。

gemini19deprecationimage-modelエージェント80移行14

11月3日の朝、10月29日が過ぎたのを確かめようと、Gemini API の deprecations 表を開きました。ところが、gemini-3.1-flash-image の行から終了日が消えていました。

いま表で終了日が付いている画像モデルは gemini-2.5-flash-image で、2027年3月15日。置き換え先は gemini-3.1-flash-lite-image です。10月7日の記事を書いたとき、私は「10月29日」を動かない日付として切り替え計画を組んでいました。表は動くのだと、このとき改めて気づきました。

最初にお伝えしたいのは、この記事の手順が日付そのものには依存していないということです。どこで画像モデルを呼んでいるかを知り、切り替える日と戻る先を、表の最新の行から決め直す——期限が動いても、この手順は使い回せます。

11月3日に読み直した表

以前、モデルの廃止日を棚卸しする方法を書きました(二次情報の「10月16日」が一次表に見当たらない — Gemini のモデル廃止日を自分で棚卸しする)。今回その台帳に写した画像モデルの行は、次のとおりです。

モデル ID終了日置き換え先
gemini-2.5-flash-image2027-03-15gemini-3.1-flash-lite-image
gemini-3.1-flash-image-preview2026-06-25(終了済み)gemini-nano-banana-2.1
gemini-3.1-flash-image未発表gemini-nano-banana-2.1
gemini-nano-banana-2.1未発表(2026-10-06 公開)なし

10月7日の時点では、gemini-3.1-flash-image に 10月29日の終了日が付いていると私は写しました。いまの表にその日付は見当たらず、当時の表示と私の写し間違いのどちらだったのかは、私の側では確かめようがありません。だからこそ、台帳には「いつ、どの表から写したか」を日付つきで残すようにしました。ID の綴りと日付は、お手元でも公式の表と見比べてから台帳に入れていただければ幸いです。

もう一つ、-preview の付いた ID と付かない ID は、表の上では別の行です。gemini-3.1-flash-image-preview は 2026年6月25日にすでに終了しており、コードにこの ID が残っていれば、いま動いていない可能性があります。台帳の突き合わせで、接尾辞まで含めて一つの ID として扱うのはそのためです。

洗い出しは、台帳との突き合わせまで一度にやります

画像モデルの呼び出しは、コードだけにあるとは限りません。エージェントの設定ファイル、環境変数の既定値、ドキュメントの例——個人開発では、半年前の自分が置いたものが思わぬところに残っています。

次のスクリプトは、リポジトリ全体から画像モデルの ID を拾い、台帳(CSV)の終了日と突き合わせます。接尾辞(-preview など)まで含めて一つの ID として扱うのが要点です。

#!/usr/bin/env python3
"""リポジトリ内の画像モデル ID を洗い出し、台帳の期限と突き合わせる。"""
import csv, re, sys, datetime as dt
from pathlib import Path
 
LEDGER = Path(sys.argv[2] if len(sys.argv) > 2 else "image_models.csv")
ROOT = Path(sys.argv[1] if len(sys.argv) > 1 else ".")
SKIP = {".git", "node_modules", ".venv", "dist", ".next"}
EXT = {".py", ".ts", ".tsx", ".js", ".mjs", ".json", ".yaml", ".yml", ".toml", ".env", ".md"}
# -preview のような接尾辞まで丸ごと拾う(接尾辞違いは別の ID として扱うため)
PAT = re.compile(r"gemini-[0-9][0-9.]*-[a-z-]*image[a-z0-9-]*")
 
def load_ledger():
    rows = {}
    with LEDGER.open(encoding="utf-8") as f:
        for r in csv.DictReader(f):
            rows[r["model_id"]] = r
    return rows
 
def main():
    ledger, today = load_ledger(), dt.date.today()
    hits = {}
    for p in ROOT.rglob("*"):
        if not p.is_file() or SKIP & set(p.parts) or p.suffix not in EXT:
            continue
        for n, line in enumerate(p.read_text(encoding="utf-8", errors="ignore").splitlines(), 1):
            for m in PAT.findall(line):
                hits.setdefault(m, []).append(f"{p.relative_to(ROOT)}:{n}")
    for mid, places in sorted(hits.items()):
        r = ledger.get(mid)
        if r is None:
            print(f"? {mid}  台帳に無い ID(公式の表で確認)  {', '.join(places)}")
            continue
        left = (dt.date.fromisoformat(r["shutdown"]) - today).days if r["shutdown"] else None
        tail = "期限なし" if left is None else (f"終了済み({-left} 日前)" if left < 0 else f"あと {left} 日")
        print(f"{'!' if left is not None and left < 30 else ' '} {mid}  {tail} → {r['replacement'] or '-'}  {', '.join(places)}")
 
main()

台帳は、上の表をそのまま CSV にしたものです。期限のない行は、空欄のままにしておきます。

model_id,shutdown,replacement
gemini-2.5-flash-image,2027-03-15,gemini-3.1-flash-lite-image
gemini-3.1-flash-image-preview,2026-06-25,gemini-nano-banana-2.1
gemini-3.1-flash-image,,
gemini-nano-banana-2.1,,

設定ファイルに 1 か所、Python に 1 か所、TypeScript に 2 か所(うち 1 つは -preview 付き)という検証用の小さなリポジトリに流したところ、11月3日の実行結果は次のとおりでした。

  gemini-2.5-flash-image  あと 132 日 → gemini-3.1-flash-lite-image  conf/agent.yaml:1, src/thumb.py:1
  gemini-3.1-flash-image  期限なし → -  src/hero.ts:1
! gemini-3.1-flash-image-preview  終了済み(131 日前) → gemini-nano-banana-2.1  src/other.ts:1

! は 30 日を切ったものと、すでに終了日を過ぎたものです。3 行目のように、終了済みの ID がコードに残っている場合は、いま動いていない可能性が高く、最優先で直す行になります。台帳に無い ID が出たときは ? が付くので、その行は公式の表で確かめてください。

切り替えは「一本の変数」と「戻り先」に分けます

呼び出し箇所が 3 つあるなら、3 つとも書き換えるのは遅いやり方です。モデル ID を返す関数を一本だけ作り、そこに切り替え日を持たせます。

import os, datetime as dt
 
# 台帳: 主モデルと戻り先、切り替え予定日
PLAN = {
    "primary": "gemini-2.5-flash-image",
    "next": "gemini-3.1-flash-lite-image",
    "cutover": dt.date(2027, 3, 6),    # 期限(3/15)の9日前
    "shutdown": dt.date(2027, 3, 15),
}
 
def pick_model(today=None):
    today = today or dt.date.today()
    forced = os.environ.get("IMAGE_MODEL")        # 手動の上書きが最優先
    if forced:
        return forced, "env"
    if today >= PLAN["shutdown"]:
        return PLAN["next"], "after-shutdown"
    if today >= PLAN["cutover"]:
        return PLAN["next"], "cutover"
    return PLAN["primary"], "primary"
 
def generate(prompt, call, today=None):
    """call(model, prompt) は各自の画像生成呼び出し。失敗したら旧モデルへ戻す。"""
    model, why = pick_model(today)
    try:
        return call(model, prompt), model
    except Exception as e:
        if model == PLAN["next"] and today_before_shutdown(today):
            print(f"[warn] {model} 失敗 ({e}) → {PLAN['primary']} に戻します")
            return call(PLAN["primary"], prompt), PLAN["primary"]
        raise
 
def today_before_shutdown(today=None):
    return (today or dt.date.today()) < PLAN["shutdown"]

日付を差し込んで動かすと、次のように振る舞います。実際の API は呼ばず、call にダミーを渡した結果です。

2026-11-03 ('gemini-2.5-flash-image', 'primary')
2027-03-06 ('gemini-3.1-flash-lite-image', 'cutover')
2027-03-15 ('gemini-3.1-flash-lite-image', 'after-shutdown')
[warn] gemini-3.1-flash-lite-image 失敗 (quota) → gemini-2.5-flash-image に戻します

なぜこう書くのか、理由を三つ挙げます。

  • 切り替え日を期限の 9 日前(3月6日)に置くのは、旧モデルがまだ動いているあいだに、新モデルの不具合を見つけるためです。
  • 環境変数での上書きを最優先にしているのは、切り替え後に「やはり戻したい」となったとき、コードを触らずに済むからです。
  • 戻り先は期限の前日までしか使えません。期限を過ぎれば、戻る先自体が無くなります。

これは検証用のスクリプトであって、本番の API 呼び出しまで確かめたものではありません。call の中身——クライアントの作り方や引数——は、お使いの構成に合わせてください。

画像モデルは、見た目で壊れます

文章モデルの差し替えなら、出力の JSON が同じ形かどうかで半分は判定できます。画像はそうはいきません。同じプロンプトでも、構図や色味、文字の入り方が変わる可能性があるからです。

私自身は、期限が近いときほど次の線引きにしています。

差し替え先の出力は、自分の目で数枚見るまで、本番に流さない。

切り替え日の前に、普段使っているプロンプトを 5 本ほど選び、新旧のモデルで 1 枚ずつ並べて眺めます。サイズ、余白、文字の崩れ。数字で測るより、目で見たほうが早く気づけます。

次の期限までに決めておくこと

いま日付が付いているのは 2027年3月15日の一つだけなので、日程はそこから逆算して置いています。

日付やること
今週中洗い出しを実行し、! と ? の行を公式の表で確認する(終了済みの -preview が残っていれば最優先)
〜2027/2月新旧モデルで同じプロンプトを並べ、見た目を確認する
2027/3/6切り替え日。旧モデルへの戻り先を残したまま新モデルへ
2027/3/15終了日。環境変数の上書きを外し、戻り先の記述を整理する

表の日付は、公式がいつでも書き換えられるものです。月に一度、台帳と表を見比べる日を決めておけば、今回のような取り違えは早い段階で拾えるのだと思います。

最初の一歩は、今日のうちに洗い出しを一度だけ流すことです。呼び出し箇所が 1 つだと分かるだけでも、気持ちはずいぶん軽くなります。この小さな習慣だけは、手放さないようにしています。

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⬡ 連携・プラグイン2026-11-21
Zed の Antigravity 設定を VS Code・JetBrains・Xcode へ移すとき、そのまま写せない3か所
Zed で動いている agy acp の登録を VS Code・JetBrains IDE・Xcode へ移すと、設定キー、コマンドのパス、認証と使えるモデルの3か所が変わります。公式手順を突き合わせた差分と、Zed の settings.json から移行先の設定を書き出す小さなスクリプトをまとめました。
⬡ 連携・プラグイン2026-11-19
エージェントの「連携できました」を、主張の一覧と小さな検証スクリプトで確かめる手順
エージェントが外部サービスとの連携作業を「完了しました」と報告しても、実物が追いついていないことがあります。報告を主張の一覧(claims.json)として書かせ、エージェントとは別の検証スクリプトでファイル・コミット・コマンド・配信先を一つずつ確かめる手順を、動くコードつきでまとめました。
⬡ 連携・プラグイン2026-11-06
Conductor を Gemini CLI 拡張から Antigravity CLI のプラグインへ。spec.md と plan.md は動かさず、導入の前後だけ見比べる
Conductor が Gemini CLI の拡張機能からプラグインになり、Antigravity CLI でも使えるようになりました。conductor/ に溜めた spec.md と plan.md は移す必要がなく、導入の前後で何も変わっていないことを確かめる小さなスクリプトと手順をお伝えします。