非推奨と移行ウォッチ
モデルは廃止され、パラメータは名称変更され、挙動は変化します。このページは、アップグレードで驚かされることがないよう 破壊的変更 を追跡します。API 上で構築するなら、定期的にざっと目を通しましょう。
なぜこれが重要なのか
固定したモデル ID は、いずれ 非推奨 となり、その後 削除 されます。それをハードコーディングしたコードは壊れます。少しの衛生管理が、深夜 2 時の不意打ちを防ぎます。
生き残るためのルール
- モデル ID は設定ファイルから読み込み、リテラルをコードベース全体に散らばらせないこと — そうすれば移行は 1 行の変更で済みます。
- 非推奨の日付や推奨される代替手段について 発表をウォッチ しましょう。
- モデルを切り替えたら 評価（evals） を再実行 しましょう — 「より新しく優れた」モデルでも挙動は変化することがあります。
- 削除後ではなく 締め切り前にテスト しましょう。
よくある変更の種類
| 変更 | 例 | 対処法 |
|---|---|---|
| モデルの廃止 | 古いモデル ID が動作しなくなる | 推奨される後継へ移行し、再評価する |
| パラメータの置き換え | 推論/予算のつまみが effort に置き換えられる | 呼び出しを更新する。思考とエフォート を参照 |
| デフォルトの変更 | 新しいデフォルトのモデル/挙動 | 意図的に固定し、プロンプトが引き続き機能するか検証する |
| エンドポイント/SDK の更新 | SDK の新しいメジャーバージョン | 移行ガイドを読み、慎重にバージョンを上げる |
現在のウォッチ
シード — 発表され次第、実際の、出典付きの非推奨通知に置き換えてください。
- 現行モデルと価格 の表に対して、あなたのモデル ID を確認してください。古い ID を使っている場合は、移行を計画しましょう。
- ここに記録されている他の破壊的変更はまだありません。信頼できるスケジュールについては 公式モデルドキュメント を追跡してください。