0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

OpenAI の /v1/models に shutdown_date が付いたので、使っているモデルの廃止を CI で落とすようにした

0
Posted at

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

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?