推奨された移行先が、すでに停止していました — Gemini の廃止表 74 行を突き合わせた記録

#!/usr/bin/env python3
"""使用中のモデル ID を、Gemini 廃止表と突き合わせて警告する。
 
deprecations.tsv の形式（タブ区切り・ヘッダなし）:
    model<TAB>shutdown(YYYY-MM-DD または空)<TAB>recommended_replacement(空可)
 
exit code は 0 = 問題なし / 1 = 要対応。CI に置くとそのまま落ちます。
"""
import sys
from datetime import date, timedelta
 
WARN_WINDOW = 90  # 何日先までを「まもなく」とみなすか
 
 
def load_table(path):
    table = {}
    with open(path, encoding="utf-8") as f:
        for line in f:
            row = line.rstrip("\n").split("\t")
            if len(row) < 3 or not row[0].strip():
                continue
            model, shutdown, replacement = (c.strip() for c in row[:3])
            table[model] = (
                date.fromisoformat(shutdown) if shutdown else None,
                replacement or None,
            )
    return table
 
 
def audit(in_use, table, today):
    """戻り値は (深刻度, モデル, 一行メッセージ) のリスト。"""
    findings = []
    for model in in_use:
        if model not in table:
            # 表にない = 廃止対象として告知されていない、か、綴り間違い。
            findings.append(("WARN", model, "廃止表に行がありません。ID の綴りを確認してください"))
            continue
        shutdown, replacement = table[model]
        if shutdown and shutdown <= today:
            findings.append(("FAIL", model, f"停止日 {shutdown} を経過しています"))
        elif shutdown and shutdown - today <= timedelta(days=WARN_WINDOW):
            findings.append(("FAIL", model, f"停止日 {shutdown}（残り {(shutdown - today).days} 日）"))
        # ここが今回の本題。移行先そのものが生きているかを見る。
        if replacement:
            if replacement not in table:
                findings.append(("WARN", model, f"推奨代替 {replacement} が廃止表にありません"))
            else:
                rep_shutdown = table[replacement][0]
                if rep_shutdown and rep_shutdown <= today:
                    findings.append(("FAIL", model, f"推奨代替 {replacement} は {rep_shutdown} に停止済みです"))
                elif rep_shutdown:
                    findings.append(("WARN", model, f"推奨代替 {replacement} にも停止日 {rep_shutdown} があります"))
    return findings
 
 
def main():
    table = load_table(sys.argv[1])
    with open(sys.argv[2], encoding="utf-8") as f:
        in_use = [l.strip() for l in f if l.strip() and not l.startswith("#")]
    findings = audit(in_use, table, date.today())
    for level, model, message in findings:
        print(f"{level}\t{model}\t{message}")
    if not findings:
        print("OK\t-\t使用中のモデルに未対応の廃止はありません")
    sys.exit(1 if any(l == "FAIL" for l, _, _ in findings) else 0)
 
 
if __name__ == "__main__":
    main()

FAIL	gemini-2.5-flash-image	停止日 2026-10-02（残り 15 日）
FAIL	gemini-2.5-flash-image	推奨代替 gemini-3.1-flash-image-preview は 2026-06-25 に停止済みです

// 論理名 -> 実モデル ID の候補列。上から順に試します。
// ここだけを書き換えれば、出荷済みのアプリの挙動も変わります。
const MODEL_CHAINS: Record<string, string[]> = {
  "image.generate": [
    "gemini-3.1-flash-image", // GA 版。廃止表に停止日なし（2026-09-17 時点）
    "gemini-2.5-flash-image", // 2026-10-02 停止。過渡期の保険としてのみ残します
  ],
  "vision.classify": ["gemini-3.8-flash", "gemini-3.6-flash"],
};
 
type Resolved = { model: string; chain: string[] };
 
export function resolveModel(logical: string): Resolved {
  const chain = MODEL_CHAINS[logical];
  if (!chain || chain.length === 0) {
    // 未知の論理名は握りつぶしません。設定ミスを本番で静かに通さないためです。
    throw new Error(`unknown logical model: ${logical}`);
  }
  return { model: chain[0], chain };
}
 
export async function callWithFallback(
  logical: string,
  body: unknown,
  apiKey: string,
): Promise<Response> {
  const { chain } = resolveModel(logical);
  let lastGone: Response | null = null;
 
  for (const model of chain) {
    const res = await fetch(
      `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`,
      {
        method: "POST",
        headers: { "content-type": "application/json", "x-goog-api-key": apiKey },
        body: JSON.stringify(body),
      },
    );
 
    // 404 は「このモデルはもう無い」。次の候補へ落とします。
    if (res.status === 404) {
      lastGone = res;
      console.warn(`model gone: ${model} (logical=${logical})`);
      continue;
    }
    // それ以外は成功も失敗もそのまま返します。429/5xx はリトライ層の仕事です。
    return res;
  }
 
  // 候補が尽きた = 設定の更新が追いついていない、という運用の失敗です。
  console.error(`all models gone for logical=${logical}, chain=${chain.join(",")}`);
  return lastGone ?? new Response("no model available", { status: 503 });
}

type Outcome =
  | { kind: "ok"; data: unknown }
  | { kind: "retry" }              // 呼び出し元がバックオフして再試行します
  | { kind: "unavailable" }        // 恒久的。ユーザーに代わりの手段を出します
  | { kind: "bug"; detail: string }; // 開発中に気づくべき誤りです
 
export async function askAi(logical: string, payload: unknown): Promise<Outcome> {
  const res = await fetch("/api/ai", {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ logical, payload }),
  });
 
  if (res.ok) return { kind: "ok", data: await res.json() };
  if (res.status === 429 || res.status >= 500) return { kind: "retry" };
  if (res.status === 404) return { kind: "unavailable" };
  return { kind: "bug", detail: `${res.status} ${await res.text()}` };
}