管理監控

Rate Limits API

使用 Rate Limits API 以程式化方式查詢您組織的 API 速率限制。

Admin API 不適用於個人帳戶。 若要與團隊成員協作並新增成員，請在 Console → Settings → Organization 中設定您的組織。

Rate Limits API 提供程式化存取為您的組織及其工作區所配置的速率限制。這與 Claude Console 中限制頁面上顯示的資訊相同。

使用此 API 來：

保持閘道和代理同步： 在啟動時和按排程讀取您目前的限制，而不是硬編碼那些在 Anthropic 調整時會產生偏差的值。
驅動內部警報： 將來自 Usage and Cost API 的使用量資料與您配置的限制進行比較。
稽核工作區配置： 驗證工作區覆寫是否符合您的佈建自動化所預期的內容。

需要 Admin API 金鑰。 這些端點需要 Admin API 金鑰，這與標準的 Claude API 金鑰不同。請參閱建立 Admin API 金鑰，以了解如何為您的組織類型建立金鑰以及應選擇哪些範圍。

快速開始

列出為您的組織配置的速率限制：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

組織速率限制

/v1/organizations/rate_limits 端點會回傳在組織層級套用於 Messages API 及其支援資源的速率限制。其他產品的限制（例如 Claude Managed Agents）不包含在內。

關鍵概念

速率限制群組： 回應中的每個項目代表一個速率限制群組。模型速率限制會被分組，使多個模型版本共享同一組限制，而其他群組則涵蓋諸如 Message Batches API、Files API、Token Counting API、代理技能和網路搜尋工具等資源。
group_type： 識別該項目涵蓋哪個限制類別。請參閱依群組類型篩選以了解值的清單。
models 清單： 對於 model_group 項目，models 欄位列出計入該群組限制的每個模型 ID 和別名。使用此清單來查詢任何模型字串屬於哪個群組。對於其他群組類型，models 為 null。
limits 清單： 每個群組帶有一個 {type, value} 配對的清單。type 欄位識別限制器（例如 requests_per_minute、input_tokens_per_minute 或 output_tokens_per_minute），而 value 是配置的限制。請參閱速率限制以了解每個限制器如何被測量和執行。

如需完整的參數詳細資訊和回應結構描述，請參閱 Organization Rate Limits API 參考文件。

列出所有組織速率限制

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "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 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}

查詢特定模型的限制

將任何模型 ID 或別名作為 model 查詢參數傳遞，以僅回傳包含它的項目：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如果模型字串不符合任何群組，端點會回傳 404 錯誤。model 參數僅在組織端點上受支援；工作區端點不接受它。

工作區速率限制

/v1/organizations/workspaces/{workspace_id}/rate_limits 端點會回傳為單一工作區配置的速率限制覆寫。

回應僅包含覆寫，因此其中缺少的任何內容都是從組織繼承的：

在 data 中不存在的群組完全沒有工作區覆寫。該工作區會繼承該群組的組織層級限制（並非無限制）。
在存在的群組中，limits[] 中不存在的限制器類型對該限制器沒有工作區覆寫。該工作區會繼承其組織的值。
對於每個存在的限制器，org_limit 是同一限制器的組織層級值，如果組織沒有為該限制器類型配置限制，則為 null。

如需完整的參數詳細資訊和回應結構描述，請參閱 Workspace Rate Limits API 參考文件。

若要取得您組織的工作區 ID，請使用 List Workspaces 端點，或在 Claude Console 中找到它們。預設工作區不能有速率限制覆寫，因此在此端點上沒有項目；請使用組織端點來讀取其限制。

cURL

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "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 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}

依群組類型篩選

兩個端點都接受一個選用的 group_type 查詢參數，將回應限制為單一類別：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

有效值為 model_group、batch、token_count、files、skills 和 web_search。

分頁

兩個端點都接受 page 查詢參數並回傳 next_page 欄位。目前回應始終是單一頁面，因此 next_page 為 null。請在 next_page 上進行迴圈，以便當回應增長時，您的用戶端無需變更即可正確分頁。

常見問題

哪些模型字串會出現在 `models` 清單中？

計入該群組的每個模型 ID 和別名，包括帶日期的 ID（例如 claude-sonnet-4-5-20250929）和不帶日期的別名（例如 claude-sonnet-4-5）。查詢您傳遞給 Messages API 的任何模型字串，您會在恰好一個 model_group 項目中找到它。

如果工作區回應中缺少某個群組，這代表什麼？

該工作區對該群組沒有覆寫，並繼承組織層級的限制。查詢組織端點以查看繼承的值。

我可以使用此 API 更新速率限制嗎？

不可以。若要設定工作區速率限制，請在 Claude Console 中開啟該工作區並使用限制分頁。

另請參閱

Was this page helpful?

管理監控

Rate Limits API

使用 Rate Limits API 以程式化方式查詢您組織的 API 速率限制。

Admin API 不適用於個人帳戶。 若要與團隊成員協作並新增成員，請在 Console → Settings → Organization 中設定您的組織。

Rate Limits API 提供程式化存取為您的組織及其工作區所配置的速率限制。這與 Claude Console 中限制頁面上顯示的資訊相同。

使用此 API 來：

保持閘道和代理同步： 在啟動時和按排程讀取您目前的限制，而不是硬編碼那些在 Anthropic 調整時會產生偏差的值。
驅動內部警報： 將來自 Usage and Cost API 的使用量資料與您配置的限制進行比較。
稽核工作區配置： 驗證工作區覆寫是否符合您的佈建自動化所預期的內容。

快速開始

列出為您的組織配置的速率限制：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

組織速率限制

/v1/organizations/rate_limits 端點會回傳在組織層級套用於 Messages API 及其支援資源的速率限制。其他產品的限制（例如 Claude Managed Agents）不包含在內。

關鍵概念

速率限制群組： 回應中的每個項目代表一個速率限制群組。模型速率限制會被分組，使多個模型版本共享同一組限制，而其他群組則涵蓋諸如 Message Batches API、Files API、Token Counting API、代理技能和網路搜尋工具等資源。
group_type： 識別該項目涵蓋哪個限制類別。請參閱依群組類型篩選以了解值的清單。
models 清單： 對於 model_group 項目，models 欄位列出計入該群組限制的每個模型 ID 和別名。使用此清單來查詢任何模型字串屬於哪個群組。對於其他群組類型，models 為 null。
limits 清單： 每個群組帶有一個 {type, value} 配對的清單。type 欄位識別限制器（例如 requests_per_minute、input_tokens_per_minute 或 output_tokens_per_minute），而 value 是配置的限制。請參閱速率限制以了解每個限制器如何被測量和執行。

如需完整的參數詳細資訊和回應結構描述，請參閱 Organization Rate Limits API 參考文件。

列出所有組織速率限制

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "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 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}

查詢特定模型的限制

將任何模型 ID 或別名作為 model 查詢參數傳遞，以僅回傳包含它的項目：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如果模型字串不符合任何群組，端點會回傳 404 錯誤。model 參數僅在組織端點上受支援；工作區端點不接受它。

工作區速率限制

/v1/organizations/workspaces/{workspace_id}/rate_limits 端點會回傳為單一工作區配置的速率限制覆寫。

回應僅包含覆寫，因此其中缺少的任何內容都是從組織繼承的：

在 data 中不存在的群組完全沒有工作區覆寫。該工作區會繼承該群組的組織層級限制（並非無限制）。
在存在的群組中，limits[] 中不存在的限制器類型對該限制器沒有工作區覆寫。該工作區會繼承其組織的值。
對於每個存在的限制器，org_limit 是同一限制器的組織層級值，如果組織沒有為該限制器類型配置限制，則為 null。

如需完整的參數詳細資訊和回應結構描述，請參閱 Workspace Rate Limits API 參考文件。

cURL

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "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 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}

依群組類型篩選

兩個端點都接受一個選用的 group_type 查詢參數，將回應限制為單一類別：

cURL

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

有效值為 model_group、batch、token_count、files、skills 和 web_search。

分頁

常見問題

哪些模型字串會出現在 `models` 清單中？

如果工作區回應中缺少某個群組，這代表什麼？

該工作區對該群組沒有覆寫，並繼承組織層級的限制。查詢組織端點以查看繼承的值。

我可以使用此 API 更新速率限制嗎？

不可以。若要設定工作區速率限制，請在 Claude Console 中開啟該工作區並使用限制分頁。

另請參閱

Was this page helpful?

快速開始

組織速率限制

關鍵概念

列出所有組織速率限制

查詢特定模型的限制

工作區速率限制

依群組類型篩選

分頁

常見問題

哪些模型字串會出現在 models 清單中？

如果工作區回應中缺少某個群組，這代表什麼？

我可以使用此 API 更新速率限制嗎？

另請參閱

快速開始

組織速率限制

關鍵概念

列出所有組織速率限制

查詢特定模型的限制

工作區速率限制

依群組類型篩選

分頁

常見問題

哪些模型字串會出現在 models 清單中？

如果工作區回應中缺少某個群組，這代表什麼？

我可以使用此 API 更新速率限制嗎？

另請參閱

快速開始

組織速率限制

關鍵概念

列出所有組織速率限制

查詢特定模型的限制

工作區速率限制

依群組類型篩選

分頁

常見問題

哪些模型字串會出現在 `models` 清單中？

如果工作區回應中缺少某個群組，這代表什麼？

我可以使用此 API 更新速率限制嗎？

另請參閱

快速開始

組織速率限制

關鍵概念

列出所有組織速率限制

查詢特定模型的限制

工作區速率限制

依群組類型篩選

分頁

常見問題

哪些模型字串會出現在 `models` 清單中？

如果工作區回應中缺少某個群組，這代表什麼？

我可以使用此 API 更新速率限制嗎？

另請參閱