10月2日に止まる gemini-2.5-flash-image の移行先は、公式表のままでは動きません

#!/usr/bin/env python3
"""Deprecations ページの「推奨移行先」を、生きているモデルまで辿る。
 
    python3 resolve_replacement.py deprecations.md
    python3 resolve_replacement.py deprecations.md gemini-2.5-flash-image
"""
import re, sys
from datetime import date, datetime
 
TODAY = date.today()
# | `model-id` | リリース日 | 停止日 | `推奨移行先` |
ROW = re.compile(
    r"\|\s*`?([a-z0-9.\-]+)`?\s*\|"   # モデル ID
    r"[^|]*\|"                        # リリース日（使いません）
    r"\s*([^|]*?)\s*\|"               # 停止日
    r"\s*`?([a-z0-9.\-]*)`?\s*\|"     # 推奨移行先
)
 
def parse_date(text):
    text = text.strip()
    if not text or "No shutdown" in text:
        return None                    # 停止日なし = 現時点では生きています
    for fmt in ("%B %d, %Y", "%b %d, %Y"):
        try:
            return datetime.strptime(text, fmt).date()
        except ValueError:
            continue
    return None
 
def load(path):
    table = {}
    with open(path, encoding="utf-8") as fh:
        for line in fh:
            m = ROW.search(line)
            if not m:
                continue
            model, shutdown_text, replacement = m.groups()
            if model in ("Model", "Preview models", "Deprecated models"):
                continue               # 表のヘッダと区切り行を落とします
            table[model] = {
                "shutdown": parse_date(shutdown_text),
                "replacement": replacement.strip() or None,
            }
    return table
 
def resolve(table, model, seen=None):
    seen = (seen or []) + [model]
    row = table.get(model)
    if row is None:
        return model, seen, "unknown"          # 表に載っていない ID
    if row["shutdown"] is None:
        return model, seen, "alive"            # ここが終点です
    nxt = row["replacement"]
    if not nxt or nxt in seen:                 # 移行先が空、または循環
        return model, seen, "dead-end"
    return resolve(table, nxt, seen)
 
def status_of(table, model):
    row = table.get(model)
    if row is None:
        return "表に載っていません"
    if row["shutdown"] is None:
        return "停止日なし"
    left = (row["shutdown"] - TODAY).days
    tail = "（停止済み）" if left <= 0 else "（あと %d 日）" % left
    return "停止日 %s%s" % (row["shutdown"].isoformat(), tail)
 
def main():
    table = load(sys.argv[1])
    targets = sys.argv[2:] or sorted(
        m for m, r in table.items() if r["shutdown"] and r["shutdown"] > TODAY
    )
    for model in targets:
        listed = (table.get(model) or {}).get("replacement")
        final, path, kind = resolve(table, model)
        print("%-42s %s" % (model, status_of(table, model)))
        print("  → 実際に移るべき先: %s (%s)" % (final, kind))
        if len(path) > 2:
            print("     経路: " + " → ".join(path))
        if listed and listed != final:
            print("  ⚠ 表の移行先 %s は %s" % (listed, status_of(table, listed)))
        print()
 
if __name__ == "__main__":
    sys.exit(main())

$ python3 resolve_replacement.py deprecations.md gemini-2.5-flash-image
gemini-2.5-flash-image                     停止日 2026-10-02（あと 20 日）
  → 実際に移るべき先: gemini-3.1-flash-image (alive)
     経路: gemini-2.5-flash-image → gemini-3.1-flash-image-preview → gemini-3.1-flash-image
  ⚠ 表の移行先 gemini-3.1-flash-image-preview は 停止日 2026-06-25（停止済み）

from google import genai
 
client = genai.Client(api_key="YOUR_API_KEY")
 
def assert_served(model_id: str) -> None:
    """models.list に現れない ID は、その場で落とします。"""
    served = {m.name.removeprefix("models/") for m in client.models.list()}
    if model_id not in served:
        near = sorted(s for s in served if s.startswith(model_id.split("-preview")[0]))
        raise SystemExit(
            "%s は配信されていません。近い ID: %s" % (model_id, ", ".join(near) or "なし")
        )
 
TARGET = "gemini-3.1-flash-image"   # 表を辿って確定させた ID
assert_served(TARGET)               # ここを通れば、あとは差し替えるだけです