ClaudeAPILinked billingEnterprise

Claude Linked billing 让客户付款,数据规则仍跟应用走

Claude Linked billing 已进入 beta,客户可用自己的 API 组织支付应用用量,但模型权限、限流和数据保留仍属于应用组织。

查看接入文档
Claude Linked billing 让客户付款,数据规则仍跟应用走

Claude 的 Linked billing 让客户把应用里的 Claude 用量付到自己的 API 组织,但请求仍运行在应用方的组织中。谁付款和谁的模型权限、限流、数据保留规则生效,要分开看。 如果客户要求沿用自己组织的零数据保留或加密密钥,这个功能不能直接满足要求。

Anthropic 于 2026 年 11 月 17 日宣布该功能进入 beta。本文在 11 月 18 日重新查阅平台更新记录和Linked billing 文档,讨论产品选择与验收边界,不提供完整 OAuth 实现,也没有实际关联组织或发起计费请求。

哪些客户能用自己的组织付款?

客户需要拥有直接向 Anthropic 支付 API 费用的 Claude Platform 组织,预付费和账单结算都可以。通过 AWS、Google Cloud 或 Azure 云市场结算的组织不符合条件;只有 Claude 订阅的组织也不符合条件。

这让它更适合已经采购官方 API 的企业客户。客户不必把长期 API Key 交给应用,而是批准一次组织连接;连接后,应用按请求决定付款方。批准关联的人需要该组织的 Admin 或 Billing 角色。

客户当前持有什么能否按这个条件参与
直接向 Anthropic 购买的 API 额度属于合资格付款方式,仍需完成关联和请求检查
直接与 Anthropic 结算的 API 账单同上
云市场结算的 Claude 组织不符合本功能条件
只有 Claude 订阅不符合本功能条件

可用于这类请求的额度也有限制。官方文档排除了部分赠送额度,包括随 Claude Max、Ultra、Team 提供的月度 API 额度,以及合作伙伴、VC、创业计划额度。不要只看客户账户显示“有余额”,就承诺能支付关联请求。

客户付款后,数据规则跟谁走?

仍跟应用方走。官方明确:请求使用应用组织的限流、模型访问、服务层级、数据保留与加密密钥。客户组织自己的 ZDR、BAA、CMEK 安排不会随付款关系转过来。

客户组织承担付款,应用组织继续提供模型权限、限流和数据策略

例如,客户采购合同要求所有推理都处于其自有 CMEK 覆盖下,产品不能因为客户勾选了“由我付款”,就向客户确认已经符合合同。官方直接提示,不要关联需要此次用量满足 HIPAA、FERPA 或 CMEK 覆盖的客户。

这与自托管 Managed Agents 的边界是相关但不同的问题:一个改变服务部署位置,一个改变模型费用归属。评估方案时,把数据经过哪里、请求属于哪个组织、谁收到模型账单分别画出来。网关与普通 API 代理的分工能帮助定位其中的路由层。

每次请求怎样选付款方?

在文档的默认 operator 服务账号调用方式下,billing_policy 可以把请求指定给客户,也可以指定给应用自己。客户付款的正文片段如下,它不是包含认证、用户档案头和模型参数的完整请求:

{
  "billing_policy": {
    "type": "billing_policy",
    "bill_to": "user_profile"
  }
}

这条调用还需要 user-profiles-billing-2026-10-01 beta 头,以及指向正确客户档案的 anthropic-user-profile-id。同样的 operator 调用若省略 billing_policy,默认由应用付款;显式 bill_to: "self" 也是应用付款。客户已关联,不会自动把之后所有请求改成客户付费。

默认 operator 调用在每次请求选择客户或应用,客户无法付款时请求被拒绝

官方还有 connection-bound access token 路径:这种令牌只能向对应客户计费,在支持的推理端点上即使省略 billing_policy 也由该客户付款;不能把前面的省略规则套过去。实现时应按官方完整身份与连接流程选择一种路径,不混用凭据语义。密钥与令牌的存放原则见API 凭据安全。

指定客户付款但无法向客户计费时,API 会拒绝请求,不会悄悄转给应用付费。如果产品想在这种情况下改为应用承担费用,需要把它作为明确的产品与预算决定,而非无条件重试。自动任务还应遵守可停止的预算设计。

哪些调用不能直接转给客户?

当前支持 billing_policy 的推理端点是 /v1/messages 和 /v1/chat/completions。/v1/messages/count_tokens 接受这个字段但忽略它,不能用计数成功证明客户能付款。

两项限制尤其容易影响应用设计:

  • 客户付费请求不能使用会产生费用的 code execution 功能,文档说明会返回 400。
  • Message Batches 暂不支持客户付款。批次里指定 bill_to: "user_profile" 的单个请求会以 invalid_request_error 失败,双方都不为该项付费,其他请求照常运行。

因此,不要在整个 SDK 上套一个“客户付款”的全局开关,再把批处理、工具执行与普通聊天一起放行。每种请求先判断是否属于受支持范围。

上线前怎样验证付款不会串到另一位客户?

先在测试应用和第二个合资格组织里完成验证;官方不允许应用关联拥有它自己的组织。建议保留以下验收记录,不记录访问令牌或正文:

场景需要观察的结果
合资格组织关联成功先显示“已关联”,不提前宣称“已可计费”
正常客户付费调用请求关联到该客户的档案与账单记录
客户额度或上限阻止付款请求失败,不自动由应用垫付
客户解除关联后续客户付费请求不能继续成功
应用自主承担的一次调用使用能由应用付款的身份,费用落在应用侧

关联、可计费、失效与应用自付需要分开验收,不能用一个成功提示代替

402 不能单独区分余额不足和支出上限;403 user_profile_not_billable 也要回到资格与连接状态排查。客户可在 Claude Console 设置应用支出上限或解除关联,产品需要说明失败后的处理方式。

本文没有确认 Nbility 提供这一官方组织关联能力;不要把官方 beta 功能当作本站已上线选项。如果你正在做企业 AI 应用,先与客户确认“希望自己承担费用”还是“要求请求完全归属自己的组织”。两个诉求会导向不同的产品方案。

相关文章

用 Nbility 跑通你的 Agent 工作流

获取 API Key,统一接入 OpenAI 兼容模型和开发工具。

获取 API Key