Claude API 的 Rate Limits API 能设置工作区的限额了，不用再进控制台改

Rate Limits API 原来只能读：查组织和各个工作区配置了哪些限流上限。官方文档在北京时间 2026 年 10 月 30 日到 31 日之间加了一节 “Set workspace rate limits”，现在可以用接口给工作区设置或清除限额，不用再进控制台一个个改。页面的说明也从“读取限额”改成了“读取组织的限额、设置工作区的限额”，Admin API、Workspaces 等几页加了指向它的链接。

开发平台的发布说明里没有这一条，所以只能写文档是这两天之间改的。

谁用得上

只有控制台组织里拿着 Admin key 的人。典型用法是自己做网关或给多个团队分工作区的公司：建工作区时顺手用脚本把限额配好，不用人去控制台点。

走中转站的读者用不上。中转站不会给你它那边的管理凭据，限流按中转站自己的规则来。

怎么用

对一个工作区的一个限流组发 POST：

POST /v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}

rate_limit_id 是这个组在组织列表里那一项的 id，或者工作区列表里那一项的 rate_limit_id。工作区还没单独设过的组，用工作区列表加 include_inherited=true 查。这些 ID 每个组织都不一样，要在自己的组织里查。

请求体是一个 limits 数组，每项一个 {type, value}。官方的例子：把一个工作区 Opus 5.5 那一组的每分钟请求数设成 2,000，同时清掉它单独设的每分钟输入 token：

curl "https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID/rate_limits/$RATE_LIMIT_ID" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "limits": [
      {"type": "requests_per_minute", "value": 2000},
      {"type": "input_tokens_per_minute", "value": null}
    ]
  }'

Python SDK 里是 client.organization.workspaces.rate_limits.update(...)，命令行工具是 ant organization:workspaces:rate-limits update。

几条规则

value 写整数（0 或以上）是设置，写 null 是清除，清除后这个工作区回到沿用组织的值。没在请求里提到的类型，保持原样。
能设哪些类型看组的类型： 模型组（model_group）能设除 tool_uses_per_second 以外的各种；联网搜索组只能设 tool_uses_per_second；批量组只能设 requests_per_minute；别的组什么都不能设。列表里能看到、但不能设的类型（比如 enqueued_batch_requests），发了返回 400。
可以设得比组织的高，但不会真的更高。 接口会把这个值存下来，执行时按工作区和组织两个值里低的那个算，响应里的 org_limit 就是组织的值。
大约一小时生效。 生效之前，这个工作区仍然按旧的值限流。
先整体检查，再逐条生效。 有一项不合法，整个请求返回 400，什么都不改；检查通过以后，逐条应用，中途有一条失败的话，前面已经生效的保留。每一项设的都是绝对值，所以失败了原样重发是安全的。
Claude Platform on AWS 上暂时不能设。
组织本身的限额，接口还是改不了，要提高得按官方说的去申请。控制台的 Rate limits 页也能给工作区设，在 Workspace 下拉框里选工作区，再点模型旁边的 Edit。

本站没有实测，以上按官方文档整理。读限额的写法和工作区的其他设置，见团队用 Claude API 之前要管好的事。

同一时期，Claude API 的每分钟请求数也提高了，见报错、限流和停止原因。

Claude API 的 Rate Limits API 能设置工作区的限额了，不用再进控制台改

谁用得上

怎么用

几条规则

来源

相关文章