本指南涵盖了使用 Claude 企业管理员 API 为 Claude 企业组织设置的支出限额和支出限额增加请求。支出限额允许您在循环周期内限制每个成员的使用额度支出,查看每个成员的限额来源,以及审查或处理成员的更高限额请求。
有关按用户和按时间段的使用情况和成本报告,请参阅Claude 企业分析 API 参考指南。
Claude 企业管理员 API 目前处于公开测试阶段,可供启用了使用额度的企业计划组织使用。
概述
共有八个端点跨越两个资源:
资源 | 端点 | 用途 |
支出限额 |
| 读取每个成员的有效限额和周期至今的支出;设置或清除按用户覆盖。 |
支出限额增加请求 |
| 列出成员的更高限额请求及做出决定所需的上下文;批准或拒绝每个请求。 |
使用支出限额端点来回答"每个成员适用什么限额,它来自哪里,他们离限额有多近?"并设置按用户覆盖。使用支出限额增加请求端点来处理成员提交的请求队列。
前置条件和身份验证
您的组织必须在 Claude 企业计划上。
必须为您的组织启用使用额度。您的主要所有者可以在 Claude 中的计费设置下启用此功能。
主要所有者需要使用以下一个或两个作用域铸造管理员 API 密钥:
read:spend_limits(所有GET端点必需)write:spend_limits(POST和DELETE端点必需)
在每个请求的x-api-key标头中传递密钥。
重要:不要公开共享 API 密钥或将其检入源代码管理。
基础 URL
https://api.anthropic.com
速率限制
所有八个端点共享单个每组织限制每分钟 60 个请求。超过限制的请求返回429 请求过多。
分页
GET /v1/organizations/spend_limits/effective和GET /v1/organizations/spend_limit_increase_requests使用不透明游标进行分页。第一个请求返回最多limit行加上next_page游标。在下一个请求中将该游标原样传递为page参数,并重复直到next_page为null。
重要:不要在序列中途更改查询参数。游标绑定到发出它们的过滤器。如果您更改user_ids[]、status[]或actor_ids[]并传递旧游标,您将收到 400 错误,显示"游标与当前查询参数不匹配"。请改为从第一页开始新序列。
将游标字符串视为不透明:不要自己解析、修改或构造它。
序列化列表参数
列表参数使用括号表示法:对每个值重复参数名称加上[]。
user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq
错误响应
状态 | 含义 |
400 | 无效输入、不支持的参数值、页面游标与当前参数不匹配,或不满足前置条件(请参阅每个端点的验证)。 |
401 | 缺少 |
403 | API 密钥缺少所需的作用域( |
404 | 找不到资源,或API密钥未知、已过期或已被撤销。 |
429 | 超出速率限制。 |
500 | 内部错误。 |
错误响应体的结构如下:
{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}
error.type 是状态相关的判别器:invalid_request_error (400)、authentication_error (401)、permission_error (403)、not_found_error (404)、rate_limit_error (429)、api_error (500)。request_id 始终存在,是联系支持时应引用的值。每个端点下的验证表列出了具体的错误消息。
概念
支出限额层级
每个成员的使用额度支出受到有效支出限额的限制,该限额从一个范围级别的层级中解析。当成员没有按用户覆盖时,他们继承为其座位层级、其组(如果您的组织使用基于组的限制)或组织范围默认值配置的限额。
读取 GET /v1/organizations/spend_limits/effective 返回每个当前成员及其解析的有效限额、该限额的解析来源(source)和其期间至今的支出。通过 POST /v1/organizations/spend_limits 设置按用户覆盖会将成员固定到特定限额,无论他们本应继承什么。删除覆盖会将他们返回到继承的限额。
范围
范围标识支出限额的写入或解析级别:
类型 | 字段 | 含义 |
|
| 特定成员。 |
|
| 座位层级默认值。 |
|
| 组默认值,当您的组织按组管理限制时。 |
| — | 组织范围的默认值。 |
scope.type 是一个开放字符串。客户端应将未知值视为不透明值并跳过,而不是失败。未来可能会添加其他范围类型。
周期
period 是强制执行限额和支出重置的循环窗口。目前唯一的值是 "monthly"。
period 是一个开放字符串。客户端应将未知值视为不透明值并跳过,而不是失败。未来可能会添加其他周期值。
金额和货币
所有货币值都是组织计费货币的最小单位的字符串(美元为美分)。例如,"50000" 表示 500.00 美元。解析为十进制并除以 100 以显示美元。对于大值,避免使用二进制浮点数。
amount 是可为空的:null 表示无限制(无限额)。"0" 表示该成员的使用额度已禁用。
period_to_date_spend 是成员自当前 period 开始以来累积的使用额度,采用相同的最小单位格式。它可能包含小数部分(例如,"41280.125")。
增加请求生命周期
当成员在 claude.ai 中点击"请求更多使用"时,会创建支出限额增加请求。请求不通过此API创建。
状态 | 含义 |
| 等待管理员操作。请求通常包含实时 |
| 请求已通过批准解决:管理员明确批准了它(按管理员提供的金额写入按用户支出限额)、另一个管理员操作使成员可以使用使用额度(例如,提高座位层级限额或为组织启用使用额度计费),或Anthropic支持代表组织提高了限额。 |
| 管理员拒绝。 |
approved 和 denied 都是终端状态。一个成员最多同时有一个 pending 请求。
通过 POST …/approve 批准会写入与 POST /v1/organizations/spend_limits 相同的按用户支出限额行。直接设置支出限额不会转换待处理请求。使用批准端点来解决请求。
默认情况下,Anthropic 在成员的请求被批准或拒绝时向其发送电子邮件。在批准或拒绝时传递 suppress_notification: true 以抑制该电子邮件(例如,当您自己的系统通知成员时)。
SpendLimit 对象
在一个范围级别配置的限制。
{
"type": "spend_limit",
"id": "spl_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-01T12:00:00Z",
"updated_at": "2026-05-03T09:14:11Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly"
}字段 | 类型 | 描述 |
| 字符串 | 始终为 |
| 字符串 | 前缀为 |
| 字符串 (RFC 3339) | 首次设置此限制的时间。 |
| 字符串 (RFC 3339) | 上次更改此限制的时间。 |
| 范围 | 此限制所在的级别。请参阅"范围"部分。 |
| 字符串或 null |
|
| 字符串 | ISO 4217。组织的计费货币。 |
| 字符串 | 强制执行 |
SpendSummary 对象
计算的每个成员报告行:成员的有效限制、其来源以及其期间至今的支出。不是可寻址资源(无 id)。
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}字段 | 类型 | 描述 |
| 范围( | 此行所对应的成员。 |
| 字符串或 null |
|
| 字符串 | ISO 4217。 |
| 字符串 |
|
| 范围 |
|
| 字符串 |
|
| 字符串 | 成员自当前 |
SpendLimitIncreaseRequest 对象
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}字段 | 类型 | 描述 |
| 字符串 | 始终为 |
| 字符串 | 前缀为 |
| 字符串 (RFC 3339) | 成员提交请求的时间。 |
| 字符串 |
|
| 字符串 (RFC 3339) 或 null | 请求被批准或拒绝的时间。待处理时为 |
| Actor 或 null | 批准或拒绝请求的人:可以是 |
| Actor ( | 提交请求的成员。 |
| SpendSummary 或 null | 请求者的实时决策上下文:其有效限制和期间至今的支出。当 |
Actor
字段 | 类型 | 描述 |
| 字符串 |
|
| 字符串 | 在 |
| 字符串或 null | 在 |
| 字符串或 null | 在 |
| 字符串 | 存在于 |
支出限额
1. 列出有效的支出限额
GET /v1/organizations/spend_limits/effective
返回组织的每个当前成员及其已解析的有效限额和本期支出。没有按用户覆盖的成员显示 source.type 为 seat_tier、rbac_group 或 organization。不列出已离职成员。
需要作用域:read:spend_limits.
查询参数
字段 | 类型 | 必需 | 默认值 | 描述 |
| 字符串,最多 100 个条目 | 否 | 所有成员 | 缩小到特定成员。接受 |
| 整数 1–1000 | 否 | 20 | 每页行数。 |
| 不透明游标字符串 | 否 | — | 前一个响应中的 |
响应字段
字段 | 类型 | 描述 |
| SpendSummary 数组 | 每个成员一个条目,按成员加入组织的时间排序(最新的在前)。 |
| 字符串或 null | 下一页的不透明游标;当没有更多页面时为 |
示例请求
curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
示例响应
{
"data": [
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}
],
"next_page": "page_..."
}
验证
条件 | 状态 | 消息 |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
组织未采用企业计划 | 400 |
|
使用额度计费未启用 | 400 |
|
2. 获取支出限额
GET /v1/organizations/spend_limits/{spend_limit_id}
按 ID 返回单个支出限额。使用此功能检查 SpendSummary.spend_limit_id 或 POST 响应引用的行。
需要范围:read:spend_limits。
路径参数
字段 | 类型 | 描述 |
| 字符串 | 前缀为 |
响应
SpendLimit 对象。
示例请求
curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
验证
条件 | 状态 | 消息 |
| 404 |
|
组织未采用企业计划 | 400 |
|
使用额度计费未启用 | 400 |
|
3. 设置支出限额
POST /v1/organizations/spend_limits
设置按用户支出限额覆盖。更新插入:为已有限额的用户设置限额会就地覆盖。
仅接受 scope.type: "user"。座位层级、组和组织级别的默认值在 claude.ai 设置中配置。
直接设置支出限额不会转换成员的待处理增加请求。使用批准端点来解决请求。
需要范围:write:spend_limits。
请求体
字段 | 类型 | 必需 | 描述 |
| 对象 | 是 |
|
| 字符串或空值 | 是 |
|
| 字符串 | 否 | 默认为 |
响应
反映已写入覆盖的 SpendLimit 对象。
示例请求
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'
示例响应
{
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:02:44Z",
"updated_at": "2026-05-11T10:02:44Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}
验证
条件 | 状态 | 消息 |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
组织不在企业计划中 | 400 |
|
未启用使用额度计费 | 400 |
|
4. 移除支出限额
DELETE /v1/organizations/spend_limits/{spend_limit_id}
移除 按用户 覆盖,使成员回退到继承的限额(座位等级、组或组织默认值)。座位等级、组和组织级别的行无法通过此端点删除。
需要范围:write:spend_limits。
路径参数
字段 | 类型 | 描述 |
| 字符串 | 前缀为 |
响应
{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }
示例请求
curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
验证
条件 | 状态 | 消息 |
| 404 |
|
| 400 |
|
组织未采用企业计划 | 400 |
|
未启用使用额度计费 | 400 |
|
支出限额增加请求
5. 列出增加请求
GET /v1/organizations/spend_limit_increase_requests
列出增加请求,最近的优先。排除请求者不再是组织成员的请求。
需要范围:read:spend_limits。
查询参数
字段 | 类型 | 必需 | 默认值 | 描述 |
|
| 否 | 全部 | 按状态筛选。重复该参数以获取多个值。 |
| 字符串 | 否 | 全部 | 按请求者筛选。接受 |
| 整数 1–1000 | 否 | 20 | 每页行数。 |
| 不透明游标字符串 | 否 | — | 来自上一个响应的 |
响应字段
字段 | 类型 | 描述 |
| SpendLimitIncreaseRequest 数组 | 按 |
| 字符串或 null | 下一页的不透明游标;当没有更多页面时为 |
示例请求
curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
示例响应
{
"data": [
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}
],
"next_page": null
}
验证
条件 | 状态 | 消息 |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
组织不在企业计划中 | 400 |
|
未启用使用额度计费 | 400 |
|
6. 获取增加请求
GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}
返回单个增加请求。
需要范围:read:spend_limits。
路径参数
字段 | 类型 | 描述 |
| 字符串 | 前缀为 |
响应
SpendLimitIncreaseRequest 对象。
示例请求
curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
验证
条件 | 状态 | 消息 |
在此组织中找不到请求 | 404 |
|
请求者不再是此组织的成员 | 404 |
|
组织未采用企业计划 | 400 |
|
未启用使用额度计费 | 400 |
|
7. 批准增加请求
POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve
批准待处理请求。在 amount 处为请求者写入 每用户支出限额,并将请求转换为 approved。如果请求不包含请求的金额,管理员在批准时提供新的限额。
需要范围:write:spend_limits。
路径参数
字段 | 类型 | 描述 |
| 字符串 | 前缀为 |
请求正文
字段 | 类型 | 必需 | 默认值 | 描述 |
| 字符串 | 是 | — |
|
| 字符串 | 否 |
| 请参阅"周期"部分。 |
| 布尔值 | 否 |
| 如果为 |
响应
状态为 approved 的 SpendLimitIncreaseRequest,包含额外的 spend_limit 字段,其中包含已写入的 SpendLimit。
示例请求
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"amount": "75000", "suppress_notification": true}'
示例响应
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "approved",
"resolved_at": "2026-05-11T10:05:02Z",
"resolved_by": {
"type": "scoped_api_key_actor",
"scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
},
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": null,
"spend_limit": {
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:05:02Z",
"updated_at": "2026-05-11T10:05:02Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}
}
验证
条件 | 状态 | 消息 |
在此组织中找不到请求 | 404 |
|
请求者不再是此组织的成员 | 404 |
|
请求已 | 400 |
|
| 400 |
|
| 400 |
|
组织不在企业计划中 | 400 |
|
未启用使用额度计费 | 400 |
|
8. 拒绝增加请求
POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny
拒绝待处理请求。在拒绝时幂等:拒绝已拒绝的请求返回200和现有资源。拒绝已批准的请求被拒绝,以便自动化可以区分重试和冲突决定。
需要范围:write:spend_limits。
路径参数
字段 | 类型 | 描述 |
| 字符串 | 前缀为 |
请求体
字段 | 类型 | 必需 | 默认值 | 描述 |
| 布尔值 | 否 |
| 如果 |
响应
状态为拒绝的SpendLimitIncreaseRequest。
示例请求
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"suppress_notification": true}'
验证
条件 | 状态 | 消息 |
在此组织中找不到请求 | 404 |
|
请求者不再是此组织的成员 | 404 |
|
请求已 | 400 |
|
请求已被 | — (200, idempotent) |
|
组织未采用企业计划 | 400 |
|
未启用使用额度 | 400 |
|
