Claude Platform Docs
管理モニタリング

Rate Limits API

Rate Limits APIを使用して、組織のAPIレート制限をプログラムで読み取り、ワークスペースのレート制限を設定します。

Rate Limits APIは、組織とそのワークスペースに設定されたレート制限へのプログラムによるアクセスを提供します。これはClaude Consoleのレート制限ページに表示される情報と同じものです。また、ワークスペースのレート制限の設定やクリアにも使用できます。

このAPIは次の用途に使用できます。

  • ゲートウェイとプロキシの同期を保つ: Anthropicが値を調整した際にずれが生じるハードコードされた値を使う代わりに、起動時および定期的に現在の制限を読み取ります。
  • 制限までの余裕を確認する: Usage and Cost Analytics APIから取得した過去の使用量を、設定済みの制限と比較します。
  • ワークスペース設定を監査する: ワークスペースのオーバーライドが、プロビジョニング自動化で想定している内容と一致していることを確認します。
  • コードからワークスペースの制限を管理する: Consoleで編集する代わりに、プロビジョニング自動化から各ワークスペースの制限を設定およびクリアします。

SDKのデフォルトクライアントとCLIは、ANTHROPIC_API_KEY環境変数からAdmin APIキーを読み取ります。SDKはこれらのエンドポイントをclient.organization.rate_limitsおよびclient.organization.workspaces.rate_limitsとして公開しています。各一覧の例のコメントには、追加のページを取得するか、最初のページのみを読み取るかが記載されています。

クイックスタート

組織に設定されたレート制限を一覧表示します。

client = anthropic.Anthropic()

rate_limits = client.organization.rate_limits.list()

# 必要に応じて追加のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value}")

組織のレート制限

/v1/organizations/rate_limitsエンドポイントは、Messages APIおよびそれをサポートするリソースに対して組織レベルで適用されるレート制限を返します。Claude Managed Agentsなど、他の製品の制限は含まれません。

主要な概念

  • レート制限グループ: レスポンスの各エントリは1つのレート制限グループを表します。モデルのレート制限はグループ化されており、複数のモデルバージョンが1組の制限を共有します。その他のグループは、Message Batches APIとウェブ検索ツールを対象とします。
  • groupオブジェクト: すべてのエントリに存在し、そのエントリが適用されるレート制限グループを識別します。常にtype(group_typeの値のいずれか)とid(rlg_プレフィックスを持つ不透明な識別子)を持ちます。model_groupエントリでは、Claude Sonnet 4.xのような、Anthropicによるそのグループの現在のラベルであるdisplay_nameも持ちます。このラベルは表示専用であり、変更される可能性があります。その他のグループタイプにはdisplay_nameはありません。
  • group内のid: グループはすべての組織およびすべてのワークスペースオーバーライドで同じidを持ち、変更されることはありません。組織間でエントリを照合したり、独自のカタログと照合したりする際に使用してください。エントリ自体のidは組織ごとに異なり、modelsはAnthropicがモデルをグループ間で移動すると変わります。どちらもグループの安定したキーではありません。
  • group_type: リストを1つのグループタイプに制限するクエリパラメータです。値についてはグループタイプによるフィルタリングを参照してください。
  • modelsリスト: model_groupエントリの場合、modelsフィールドには、そのグループの制限に対してカウントされるすべてのモデルIDとエイリアスが一覧表示されます。このリストを使用して、任意のモデル文字列がどのグループに属するかを調べることができます。その他のグループタイプでは、modelsはnullです。
  • limitsリスト: 各グループは{type, value}ペアのリストを持ちます。typeフィールドはリミッター(requests_per_minute、input_tokens_per_minute、output_tokens_per_minuteなど)を識別し、valueは設定された制限値です。各リミッターの測定方法と適用方法については、レート制限を参照してください。
  • ワークスペース制限のsource: ワークスペースエンドポイントでは、すべての制限値がsourceも持ちます。これはvalueの出所を示し、ワークスペースに保存されたオーバーライドの場合は{"type": "workspace"}、組織から継承された値の場合は{"type": "organization"}となります。デフォルトでは、ワークスペースエンドポイントはオーバーライドのみを返すため、そこでのsource.typeは常にworkspaceです。継承された値はinclude_inherited=trueを渡すと表示されます。ワークスペースのレート制限を参照してください。

パラメータの詳細とレスポンススキーマの全体については、組織のレート制限APIリファレンスAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。を参照してください。

組織のすべてのレート制限を一覧表示する

client = anthropic.Anthropic()

rate_limits = client.organization.rate_limits.list()

# 必要に応じて追加のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value}")
{
  "data": [
    {
      "id": "rlt_01NwFawrTvAijwqn8AjKVBPS",
      "type": "rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Hq7YkP3mZ9dTwRx4cVbN2s",
        "display_name": "Claude Opus 5.5"
      },
      "models": ["claude-opus-5-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "id": "rlt_016qriyigbdebqkzhMujdHkX",
      "type": "rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Kd5wMv8nSq2LcXy6tRfJ4b",
        "display_name": "Claude Opus 4.x"
      },
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "id": "rlt_01EyY8kq14eviKJPgepbgBH4",
      "type": "rate_limit",
      "group": { "type": "batch", "id": "rlg_01Wn3pBz6kCg9vHtQ7mLxD5a" },
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}

特定のモデルの制限を調べる

任意のモデルIDまたはエイリアスをmodelクエリパラメータとして渡すと、それを含むエントリのみが返されます。

client = anthropic.Anthropic()

rate_limits = client.organization.rate_limits.list(model="claude-opus-5-5")

# 必要に応じて後続のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value}")

モデル文字列がどのグループにも一致しない場合、エンドポイントは404エラーを返します。組織がアクセスできるモデルはすべて、そのグループに一致します。modelパラメータは組織エンドポイントでのみサポートされており、ワークスペースエンドポイントでは受け付けられません。

ワークスペースのレート制限

/v1/organizations/workspaces/{workspace_id}/rate_limitsエンドポイントは、単一のワークスペースに設定されたレート制限のオーバーライドを返します。ワークスペースが継承する値も確認するには、include_inherited=trueを渡してください(継承された値を含めるを参照)。オーバーライドを変更するには、ワークスペースのレート制限を設定するを参照してください。

デフォルトでは、レスポンスにはオーバーライドのみが含まれるため、レスポンスに含まれていないものはすべて組織から継承されます。

  • dataに存在しないグループには、ワークスペースのオーバーライドがまったくありません。ワークスペースはそのグループについて組織レベルの制限を継承します(無制限になるわけではありません)。
  • 存在するグループ内で、limits[]に存在しないリミッタータイプには、そのリミッターに対するワークスペースのオーバーライドがありません。ワークスペースはその値を組織から継承します。
  • 存在する各リミッターについて、org_limitは同じリミッターの組織レベルの値であり、組織にそのリミッタータイプの制限が設定されていない場合はnullです。また、sourceは{"type": "workspace"}です。

パラメータの詳細とレスポンススキーマの全体については、ワークスペースのレート制限APIリファレンスAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。を参照してください。

client = anthropic.Anthropic()

rate_limits = client.organization.workspaces.rate_limits.list(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
)

# 必要に応じて追加のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value}")
{
  "data": [
    {
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
      "rate_limit_id": "rlt_01NwFawrTvAijwqn8AjKVBPS",
      "type": "workspace_rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Hq7YkP3mZ9dTwRx4cVbN2s",
        "display_name": "Claude Opus 5.5"
      },
      "models": ["claude-opus-5-5"],
      "limits": [
        {
          "type": "requests_per_minute",
          "value": 1000,
          "org_limit": 4000,
          "source": { "type": "workspace" }
        },
        {
          "type": "input_tokens_per_minute",
          "value": 500000,
          "org_limit": 10000000,
          "source": { "type": "workspace" }
        }
      ]
    },
    {
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
      "rate_limit_id": "rlt_016qriyigbdebqkzhMujdHkX",
      "type": "workspace_rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Kd5wMv8nSq2LcXy6tRfJ4b",
        "display_name": "Claude Opus 4.x"
      },
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        {
          "type": "requests_per_minute",
          "value": 1000,
          "org_limit": 4000,
          "source": { "type": "workspace" }
        },
        {
          "type": "input_tokens_per_minute",
          "value": 500000,
          "org_limit": 10000000,
          "source": { "type": "workspace" }
        }
      ]
    }
  ],
  "next_page": null
}

継承された値を含める

ワークスペースに適用される制限を1回のリクエストで読み取るには、オプションのinclude_inheritedクエリパラメータを追加します。デフォルトはfalseで、ブール値でない値を指定すると400エラーが返されます。include_inherited=trueを指定した場合:

  • dataには、ワークスペースに適用され、かつ組織レベルの値を持つグループごとに1つのエントリが含まれます。ワークスペースがそのグループを一切オーバーライドしていない場合も同様です。モデルグループは、ワークスペースがそのモデルの少なくとも1つにアクセスできる場合に適用されます。
  • 各エントリのlimits[]には、組織がそのグループに値を持つすべてのリミッタータイプと、ワークスペースがオーバーライドしているすべてのタイプが一覧表示されます。各タイプは1回だけ表示され、オーバーライドが保存されている場合はワークスペースのオーバーライド、それ以外の場合は組織の値が使われるため、1つのエントリに両方が混在することがあります。
  • 各値のsourceで両者を区別できます。{"type": "workspace"}は保存されたオーバーライドであり、{"type": "organization"}は継承された値で、その場合valueはorg_limitと等しくなります。
client = anthropic.Anthropic()

rate_limits = client.organization.workspaces.rate_limits.list(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    include_inherited=True,
)

# 必要に応じて後続のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value} ({limit.source.type})")
{
  "data": [
    {
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
      "rate_limit_id": "rlt_01NwFawrTvAijwqn8AjKVBPS",
      "type": "workspace_rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Hq7YkP3mZ9dTwRx4cVbN2s",
        "display_name": "Claude Opus 5.5"
      },
      "models": ["claude-opus-5-5"],
      "limits": [
        {
          "type": "requests_per_minute",
          "value": 1000,
          "org_limit": 4000,
          "source": { "type": "workspace" }
        },
        {
          "type": "input_tokens_per_minute",
          "value": 500000,
          "org_limit": 10000000,
          "source": { "type": "workspace" }
        },
        {
          "type": "output_tokens_per_minute",
          "value": 800000,
          "org_limit": 800000,
          "source": { "type": "organization" }
        }
      ]
    },
    {
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
      "rate_limit_id": "rlt_016qriyigbdebqkzhMujdHkX",
      "type": "workspace_rate_limit",
      "group": {
        "type": "model_group",
        "id": "rlg_01Kd5wMv8nSq2LcXy6tRfJ4b",
        "display_name": "Claude Opus 4.x"
      },
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        {
          "type": "requests_per_minute",
          "value": 1000,
          "org_limit": 4000,
          "source": { "type": "workspace" }
        },
        {
          "type": "input_tokens_per_minute",
          "value": 500000,
          "org_limit": 10000000,
          "source": { "type": "workspace" }
        },
        {
          "type": "output_tokens_per_minute",
          "value": 800000,
          "org_limit": 800000,
          "source": { "type": "organization" }
        }
      ]
    },
    {
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
      "rate_limit_id": "rlt_01EyY8kq14eviKJPgepbgBH4",
      "type": "workspace_rate_limit",
      "group": { "type": "batch", "id": "rlg_01Wn3pBz6kCg9vHtQ7mLxD5a" },
      "models": null,
      "limits": [
        {
          "type": "enqueued_batch_requests",
          "value": 500000,
          "org_limit": 500000,
          "source": { "type": "organization" }
        }
      ]
    }
  ],
  "next_page": null
}

ワークスペースのレート制限を設定する

1つのレート制限グループについてワークスペースのレート制限を設定またはクリアするには、/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id} に POST リクエストを送信します。rate_limit_id には、組織エンドポイントから取得したグループのエントリの id、またはワークスペース一覧エンドポイントから取得したグループのエントリの rate_limit_id を渡します。ワークスペースがまだオーバーライドしていないグループのIDを確認するには、include_inherited=true を指定してワークスペース一覧エンドポイントを呼び出します。これにより、制限を設定できるグループが返されます。これらのIDは組織ごとに異なるため、管理する各組織でそれぞれ確認してください。

リクエストボディには、1つ以上の{type, value}エントリからなるlimits配列があり、各エントリはそれぞれ異なるリミッタータイプに対応します:

  • 0以上の整数であるvalueは、そのリミッタータイプに対するワークスペースのオーバーライドを設定します。
  • nullのvalueはオーバーライドをクリアし、ワークスペースは再び組織の値を継承します。オーバーライドのないリミッタータイプをクリアしても何も変わりません。
  • リクエストで指定されていないリミッタータイプは、現在の値を維持します。

設定できるリミッタータイプは次のとおりです:requests_per_minute、input_tokens_per_minute、output_tokens_per_minute、input_tokens_per_minute_cache_aware、tokens_per_minute、tokens_per_day、tool_uses_per_second、およびリストエンドポイントで組織に対して表示される場合は、高速モードの制限であるfast_itpmca(1分あたりの入力トークン数、キャッシュ対応)とfast_otpm(1分あたりの出力トークン数)です。グループがどのタイプを受け付けるかは、そのgroup.typeによって異なります:

  • model_group:tool_uses_per_secondを除くすべてのタイプ
  • web_search:tool_uses_per_secondのみ
  • batch:requests_per_minuteのみ

前述のリミッタータイプは、これらのどのグループでもクリアできます。リストエンドポイントは、enqueued_batch_requestsなど設定できないリミッタータイプを返すことがあります。それを送信すると400エラーが返されます。

APIは同じリミッタータイプについて組織の制限を超える値も保存しますが、適用されるのは2つのうち低い方です。レスポンスのorg_limitは組織の値を示します。

変更は約1時間以内に反映されます。変更が反映されるまで、ワークスペースのリクエストは引き続き以前の値で制限されます。

APIは何かを変更する前にリクエスト全体をチェックするため、無効なエントリがあるとリクエストは400エラーで失敗し、何も変更されません。リクエストが検証を通過すると、APIはエントリを1つずつ適用します。いずれかのエントリの適用に失敗した場合、リクエストはエラーを返し、それより前のエントリは適用されたままになります。各エントリは絶対値を設定またはクリアするため、同じリクエストを安全に再送信できます。再送信すると、その間に他の誰かが、リクエストで指定されたリミッタータイプに対して行った変更はすべて置き換えられます。

Claude Opus 5.5グループに対するワークスペースの1分あたりのリクエスト数を2,000に引き上げ、1分あたりの入力トークン数のオーバーライドをクリアします:

client = anthropic.Anthropic()

entry = client.organization.workspaces.rate_limits.update(
    "rlt_01NwFawrTvAijwqn8AjKVBPS",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    limits=[
        {"type": "requests_per_minute", "value": 2000},
        {"type": "input_tokens_per_minute", "value": None},
    ],
)

for limit in entry.limits:
    print(f"{limit.type}: {limit.value}")

レスポンスはグループのエントリで、ワークスペースリストエンドポイントのdataリスト内の1つのエントリと同じ形式です。そのlimitsには、変更後のそのグループに対するワークスペースのオーバーライドが一覧表示されます。クリアされたリミッタータイプは一覧に含まれず、オーバーライドが残っていない場合limitsは空になります。直後に行ったリストリクエストにまだ反映されていない場合でも、レスポンスにはリクエストによる変更が含まれます。

{
  "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
  "rate_limit_id": "rlt_01NwFawrTvAijwqn8AjKVBPS",
  "type": "workspace_rate_limit",
  "group": {
    "type": "model_group",
    "id": "rlg_01Hq7YkP3mZ9dTwRx4cVbN2s",
    "display_name": "Claude Opus 5.5"
  },
  "models": ["claude-opus-5-5"],
  "limits": [
    {
      "type": "requests_per_minute",
      "value": 2000,
      "org_limit": 4000,
      "source": { "type": "workspace" }
    }
  ]
}

このエンドポイントは、無効なリクエストまたはアーカイブされたワークスペースに対して400エラーを返します。ワークスペースが見つからない場合、またはrate_limit_idがワークスペースで使用できないグループを指している場合は404エラーを返します。

グループタイプによるフィルタリング

どちらのリストエンドポイントも、レスポンスを単一のカテゴリに制限するオプションのgroup_typeクエリパラメータを受け付けます:

client = anthropic.Anthropic()

rate_limits = client.organization.rate_limits.list(group_type="batch")

# 必要に応じて次のページを自動的に取得します。
for entry in rate_limits:
    models = f" ({', '.join(entry.models)})" if entry.models else ""
    print(f"{entry.group.type}{models}")
    for limit in entry.limits:
        print(f"  {limit.type}: {limit.value}")

有効な値はmodel_group、batch、token_count、files、skills、web_searchです。token_count、files、skillsの値は空のdataリストを返します。これは、どちらのリストエンドポイントもToken Counting API、Files API、Skills APIの制限を返さないためです。

ページネーション

どちらのリストエンドポイントも、オプションのlimitおよびpageクエリパラメータを受け付け、next_pageフィールドを返します。limitの範囲は1から1,000です。省略した場合、レスポンスには残りのすべてのエントリが含まれ、next_pageはnullになります。limitによってリストが途中で区切られた場合、next_pageにはカーソルが入ります。次のエントリを取得するには、同じフィルターを指定したうえで、それをpageとして渡してください。クライアントがすべてのエントリを取得できるよう、next_pageでループしてください。

よくある質問

modelsリストにはどのモデル文字列が表示されますか?

日付付きID(claude-sonnet-4-5-20250929など)や日付なしエイリアス(claude-sonnet-4-5など)を含め、そのグループに対してカウントされるすべてのモデルIDとエイリアスが表示されます。Messages APIに渡す任意のモデル文字列を調べると、ちょうど1つのmodel_groupエントリに見つかります。

リストは組織がアクセスできるモデルを対象とするため、組織によって異なる場合があります。

ワークスペースのレスポンスにグループが含まれていない場合、何を意味しますか?

デフォルトでは、ワークスペースのレスポンスにはオーバーライドのみが一覧表示されるため、含まれていないグループにはワークスペースのオーバーライドがなく、組織レベルの制限を継承します。ワークスペースエンドポイントで継承された値を確認するにはinclude_inherited=trueを渡すか、組織エンドポイントを照会してください。include_inherited=trueの場合、グループが含まれないのは、そのグループがワークスペースに適用されない場合、または組織にそのグループの制限が設定されていない場合のみです。

このAPIでレート制限を更新できますか?

ワークスペースの場合: はい。ワークスペースのレート制限を設定API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。エンドポイントは、1つのレート制限グループについてワークスペースのオーバーライドを設定またはクリアします。rate_limit_idには、group内のrlg_ idではなく、組織エンドポイントのレスポンス内の該当エントリのトップレベルのidを渡してください。ワークスペースのオーバーライドと組織レベルの制限のうち低い方が適用され、変更は約1時間以内に反映されます。リクエストボディと例については、ワークスペースのレート制限を設定するを参照してください。また、Claude Consoleのレート制限ページでもワークスペースのレート制限を設定できます。ワークスペースドロップダウンメニューからワークスペースを選択し、モデルの横にある編集をクリックしてください。

組織の場合: いいえ。より高い制限をリクエストするには、より高い制限のリクエストを参照してください。

関連項目

このページは役に立ちましたか?