管理监控

速率限制 API

使用速率限制 API 以编程方式查询您组织的 API 速率限制。

Admin API 不适用于个人账户。 如需与团队成员协作并添加成员，请在 Console → Settings → Organization 中设置您的组织。

速率限制 API 提供对为您的组织及其工作区配置的 rate limit（速率限制）的编程访问。这与 Claude Console 中限制页面上显示的信息相同。

使用此 API 可以：

保持网关和代理同步： 在启动时和按计划读取您当前的限制，而不是硬编码那些在 Anthropic 调整时会产生偏差的值。
支持内部告警： 将来自用量和成本 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 是配置的限制值。有关每个限制器如何测量和执行的信息，请参阅速率限制。

有关完整的参数详细信息和响应模式，请参阅组织速率限制 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。

有关完整的参数详细信息和响应模式，请参阅工作区速率限制 API 参考。

要检索您组织的工作区 ID，请使用列出工作区端点，或在 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?

管理监控

速率限制 API

使用速率限制 API 以编程方式查询您组织的 API 速率限制。

Admin API 不适用于个人账户。 如需与团队成员协作并添加成员，请在 Console → Settings → Organization 中设置您的组织。

速率限制 API 提供对为您的组织及其工作区配置的 rate limit（速率限制）的编程访问。这与 Claude Console 中限制页面上显示的信息相同。

使用此 API 可以：

保持网关和代理同步： 在启动时和按计划读取您当前的限制，而不是硬编码那些在 Anthropic 调整时会产生偏差的值。
支持内部告警： 将来自用量和成本 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 是配置的限制值。有关每个限制器如何测量和执行的信息，请参阅速率限制。

有关完整的参数详细信息和响应模式，请参阅组织速率限制 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。

有关完整的参数详细信息和响应模式，请参阅工作区速率限制 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 更新速率限制吗？

另请参阅