Models API

一覧を返す GET /v1/models と、特定のモデルの情報を返す GET /v1/models/{model_id} があります。各モデルについて、対応している機能、入力コンテキストの上限、ライフサイクル段階などを取得できます。アプリケーションからどのモデルを使うかを判断する場面に関わる機能です。

Models API には 2 つのエンドポイントがあります。

• List Models (GET /v1/models): API で利用できるモデルの一覧を返します。新しくリリースされたモデルが先に並びます。
• Get a Model (GET /v1/models/{model_id}): 特定のモデルの情報を返します。モデルのエイリアスをモデル ID に解決する用途にも使えます。

一覧の取得では、次のクエリパラメーターを使えます。

• limit: 1 ページあたりの件数です。既定値は 20 で、1〜1000 の範囲で指定します。
• after_id / before_id: ページ送りのカーソルです。レスポンスの last_id を次のページの after_id に、first_id を前のページの before_id に使えます。
• lifecycle: 指定したライフサイクル段階 (active・deprecated・retired) のモデルに絞り込みます。値は 3 つまで指定できます。

各モデルのエントリには capabilities オブジェクトが含まれます。機能名とその対応状況を対応付けたもので、既知の機能のキーは常にすべて含まれます。主な内容は次のとおりです。

• Batch API への対応
• 画像のコンテンツブロックを受け付けるか
• PDF のコンテンツブロックを受け付けるか
• structured output / JSON mode / strict tool schemas への対応
• effort (reasoning_effort) への対応と、使える effort のレベル
• server_tools: Web 検索ツールとコード実行ツールを受け付けるか
• トップレベルの code_execution: コードがリクエスト内の他のツールを呼び出せるか
• thinking.types: リクエストで受け付ける thinking.type の値

thinking.types の各キーは、それぞれ単独で読みます。たとえば enabled が false で、disabled が true という組み合わせもあります。

このほか、各モデルには line フィールドがあり、モデルが属するモデルライン (例: opus) を返します。どのラインにも属さないモデルでは null です。ラインはモデルの id から推測せず、このフィールドで判断します。入力コンテキストの上限は max_input_tokens、max_tokens パラメーターに指定できる最大値は max_tokens で確認できます。

各モデルの lifecycle フィールドは、現在のライフサイクル段階を active・deprecated・retired のいずれかで示します。

一覧の取得で lifecycle パラメーターを省略すると、active と deprecated のモデルだけが返ります。retired のモデルは、retired を明示的に指定した場合にだけ含まれます。

retires_at は、そのモデルの現時点で予定されている提供終了日です。この日付は、実際に提供が終了するまで変更される場合があります。deprecated のモデルで retires_at が過去の日付になっていても、それは提供終了が予定より遅れていることを示すもので、終了したことを意味しません。提供終了の判断には lifecycle を使います。

• anthropic-workspace-id ヘッダーは、リクエストの対象となる Workspace を選びます。このヘッダーが必要なのは、複数の Workspace を操作できる認証情報を使う場合だけです。特定の Workspace に属する認証情報では省略でき、送る場合はその Workspace と一致させます。
• server_tools でツールに対応しているモデルでも、組織の設定によってツールが拒否される場合があります。たとえば、管理者が Web 検索をオフにしている場合です。

ここでは、モデル一覧を取得する流れを示します。

1. リクエストに anthropic-version ヘッダーを付けます (例: anthropic-version: 2026-10-21)。
2. Authorization: Bearer $ANTHROPIC_API_KEY ヘッダーで API キーを渡します。
3. GET /v1/models にリクエストを送り、モデルの一覧を受け取ります。特定のモデルを取得する場合は、同じヘッダーで GET /v1/models/$MODEL_ID に送ります。