2026-12-11 に、OpenAI API の gpt-5 / gpt-5-mini / gpt-5-nano / o3 などのスナップショットが提供終了になります。今日(2026-11-16)からあと 25 日です。
OpenAI は対象モデルを「実際に使っている顧客」にメールで通知しています。ただ、API キーを発行したアカウントのメールを、コードを書いている本人が読んでいるとは限りません。モデル ID は設定ファイルや環境変数に散らばっていて、気づいたときには本番が 404 を返している、という事故はよくあります。
そこで、GET /v1/models の shutdown_date フィールドを使って、自分が使っているモデルに廃止日が付いたら CI を落とすスクリプトを書きました。標準ライブラリだけで動きます。
shutdown_date フィールド
OpenAI の API リファレンスでは、Model オブジェクトに次のフィールドがあります(2026-11-16 確認)。
| フィールド | 型 | 説明 |
|---|---|---|
id |
string | モデル ID |
created |
integer | 作成日時(Unix 秒) |
object |
"model" |
常に "model"
|
owned_by |
string | 所有組織 |
shutdown_date |
string(date)または null、省略可 | 提供終了日。未発表なら null |
一覧(GET /v1/models)でも、個別取得(GET /v1/models/{model})でも返ります。廃止予定ページ(Deprecations)にも「各モデルの shutdown_date を確認できる」と書かれています。
まず jq で一覧を見るだけならこれで足ります。
curl -s https://api.openai.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY" \
| jq -r '.data[] | select(.shutdown_date != null) | "\(.shutdown_date)\t\(.id)"' \
| sort
ただ、これは「廃止予定のモデル全部」です。知りたいのは「自分が使っているモデルのうち、どれが何日後に止まるか」なので、もう一段書きます。
スクリプト
使っているモデル ID を渡すと、状態を 1 行ずつ出します。
#!/usr/bin/env python3
"""Check the models you use against shutdown_date on GET /v1/models.
Standard library only. Python 3.9+.
export OPENAI_API_KEY=sk-...
python3 model_shutdown_check.py --models gpt-4o-2024-08-06,gpt-5-mini
python3 model_shutdown_check.py --models-file models.txt --fail-days 30
Exit codes:
0 nothing within --fail-days
1 a model you use shuts down within --fail-days, or is not in the list at all
2 request failed
3 the endpoint does not return shutdown_date for any model (cannot tell)
"""
from __future__ import annotations
import argparse
import datetime as dt
import json
import os
import sys
import urllib.request
def fetch_models(base_url: str, key: str, timeout: float = 30):
req = urllib.request.Request(base_url.rstrip("/") + "/models",
headers={"Authorization": f"Bearer {key}"})
with urllib.request.urlopen(req, timeout=timeout) as resp:
return json.load(resp)["data"]
def check(models: list[dict], used: list[str], today: dt.date, warn_days: int, fail_days: int):
"""Return (rows, field_present). Each row is (model, status, shutdown_date_or_None, days_or_None)."""
by_id = {m["id"]: m for m in models}
field_present = any("shutdown_date" in m for m in models)
rows = []
for mid in used:
m = by_id.get(mid)
if m is None:
rows.append((mid, "NOT_LISTED", None, None))
continue
if "shutdown_date" not in m:
rows.append((mid, "UNKNOWN", None, None))
continue
sd = m["shutdown_date"]
if not sd:
rows.append((mid, "OK", None, None))
continue
days = (dt.date.fromisoformat(sd) - today).days
status = "FAIL" if days <= fail_days else "WARN" if days <= warn_days else "SCHEDULED"
rows.append((mid, status, sd, days))
return rows, field_present
def main(argv=None) -> int:
p = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
p.add_argument("--base-url", default=os.environ.get("OPENAI_BASE_URL", "https://api.openai.com/v1"))
p.add_argument("--api-key", default=os.environ.get("OPENAI_API_KEY", ""))
p.add_argument("--models", default="", help="comma-separated model IDs you use")
p.add_argument("--models-file", help="one model ID per line; # starts a comment")
p.add_argument("--warn-days", type=int, default=90)
p.add_argument("--fail-days", type=int, default=30)
p.add_argument("--today", help="YYYY-MM-DD, for testing")
a = p.parse_args(argv)
used = [s.strip() for s in a.models.split(",") if s.strip()]
if a.models_file:
with open(a.models_file, encoding="utf-8") as f:
used += [ln.split("#")[0].strip() for ln in f if ln.split("#")[0].strip()]
used = list(dict.fromkeys(used))
if not used:
p.error("give --models or --models-file")
try:
models = fetch_models(a.base_url, a.api_key)
except Exception as e: # HTTP errors, timeouts, bad JSON
print(f"error: {type(e).__name__}: {e}", file=sys.stderr)
return 2
today = dt.date.fromisoformat(a.today) if a.today else dt.date.today()
rows, field_present = check(models, used, today, a.warn_days, a.fail_days)
for mid, status, sd, days in rows:
tail = f" {sd} ({days} days)" if sd else ""
print(f"{status:<10} {mid}{tail}")
if not field_present:
print("\nno model in the response has a shutdown_date field: this endpoint cannot tell you", file=sys.stderr)
return 3
return 1 if any(s in ("FAIL", "NOT_LISTED") for _, s, _, _ in rows) else 0
if __name__ == "__main__":
sys.exit(main())
判定はこうしています。
| 状態 | 条件 | 終了コード |
|---|---|---|
OK |
shutdown_date が null |
0 |
SCHEDULED |
廃止日あり、--warn-days(既定 90 日)より先 |
0 |
WARN |
廃止日まで --warn-days 以内 |
0 |
FAIL |
廃止日まで --fail-days(既定 30 日)以内 |
1 |
NOT_LISTED |
一覧にない | 1 |
UNKNOWN |
そのモデルに shutdown_date フィールド自体がない |
— |
こだわったのは次の 2 点です。
一覧にないモデルを失敗扱いにする。 すでに提供終了したか、そのキーでは使えないモデルです。どちらにしても本番で呼べば失敗するので、見逃したくありません。
フィールドが返ってこないエンドポイントでは終了コード 3 にする。 OpenAI 互換をうたうエンドポイントでも、/v1/models が shutdown_date を返すとは限りません。フィールドがないまま「該当なし」で 0 を返すと、CI は緑のまま何も守っていない状態になります。分からないときは分からないと言わせます。
実行例(日付を固定しています):
$ python3 model_shutdown_check.py --today 2026-11-16 \
--models gpt-4o-2024-08-06,gpt-5,gpt-6-luna,gpt-5.1
WARN gpt-4o-2024-08-06 2027-01-14 (59 days)
FAIL gpt-5 2026-12-11 (25 days)
OK gpt-6-luna
SCHEDULED gpt-5.1 2027-04-01 (136 days)
この実行例は、公式リファレンスのスキーマと Deprecations ページの日付をそのまま返すモックサーバーで取ったものです。手元に OpenAI 本体のキーがないため、本家エンドポイントに対しては実行していません。テストは 4 件(状態判定、全件 OK、フィールドなし、HTTP エラー)をモックで通しています。
使っているモデル ID を集める
--models-file には 1 行 1 ID で書きます。# 以降はコメントです。最初の一覧は、リポジトリを grep して作るのが早いです。
git grep -hoE '\b(gpt|chatgpt|whisper|tts|o[0-9])-[A-Za-z0-9.-]+' -- ':!*.lock' \
| sort -u > models.txt
o3 のようにハイフンのない ID はこのパターンでは拾えないので、手で足してください。また、grep で拾えるのはリポジトリ内だけです。シークレット管理、CI の変数、Terraform や Helm の values、管理画面に手入力した ID も確認してください。
ひとつ注意があります。Deprecations ページでは、GPT-4o 系の 2027-01-14 の対象が gpt-4o-2024-08-06 のような日付付きスナップショットで列挙されています。コードに書いてあるのがエイリアスかスナップショットかで結果が変わるので、実際に送っている ID をそのまま入れてください。
GitHub Actions で週 1 回回す
name: model-shutdown-check
on:
schedule:
- cron: "0 0 * * 1" # 毎週月曜 09:00 JST
workflow_dispatch:
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- run: python3 tools/model_shutdown_check.py --models-file models.txt --fail-days 30
env:
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
失敗すれば通常の通知が飛びます。WARN の段階で気づきたいなら、--fail-days を 90 に上げてしまうのも手です。
ゲートウェイ経由で使っている場合
OpenAI 互換のゲートウェイやプロキシを挟んでいると、/v1/models はゲートウェイ側の一覧を返します。shutdown_date を付けて返すとは限りません。
開示:私は API ゲートウェイ(byesu)の開発・運用に関わっています。2026-11-16 時点で、このゲートウェイの /v1/models は shutdown_date を返しません。実際にこのスクリプトを向けると、UNKNOWN と終了コード 3 になります。ゲートウェイを使っている方は、どのゲートウェイであっても一度確かめてみてください。
ゲートウェイ経由の場合は、次のどちらかになります。
- 判定だけ OpenAI 本体のキーで行う(
--base-urlを既定のままにする)。モデル一覧を読むだけなので、推論の料金はかかりません - 公式の Deprecations ページを定期的に確認する
ゲートウェイがモデル名を別名で受けている場合は、裏で実際にどの OpenAI のモデル ID に送っているかも確認が必要です。
直近の廃止予定
OpenAI 公式 Deprecations ページより(2026-11-16 確認、モデルのみ抜粋)。
| 提供終了日 | 主な対象 | 公式の移行先 |
|---|---|---|
| 2026-12-01 |
gpt-image-1-mini、gpt-image-1.5、chatgpt-image-latest
|
gpt-image-2.6-sunburst / gpt-image-2.6-flare
|
| 2026-12-11 |
gpt-5、o3
|
gpt-6.1-sol |
| 2026-12-11 | gpt-5-mini |
gpt-6.1-terra |
| 2026-12-11 | gpt-5-nano |
gpt-6-luna |
| 2027-01-14 | GPT-4o / GPT-4.1 系のスナップショット | gpt-6-luna |
| 2027-04-01 |
gpt-5.1、gpt-5.3-codex
|
gpt-6-sol |
この表もいずれ古くなります。最新は公式ページか、上のスクリプトで確認してください。
まとめ
-
GET /v1/modelsのshutdown_dateで、廃止日を API から取れる - 「使っているモデルだけ」を照合して、30 日以内か一覧にないなら CI を落とす
- フィールドが返らないエンドポイントでは「該当なし」ではなく「判定不能」にする
- ゲートウェイ経由なら、判定は本家のキーで行うか、公式ページを見る
出典:
2026 年 12 月のモデル変更(OpenAI 以外も含む)は、移行先と確認手順をこちらにまとめています:
https://docs.byesu.com/ja/articles/model-changes-december-2026