Anthropic Python SDK v1.11.0 发布：新增支出限额查询接口

版本概览

Anthropic 官方的 Python SDK（anthropic-sdk-python）发布了 v1.11.0 版本。作为开发者调用 Claude 系列模型的官方工具库，该仓库在 GitHub 上已积累约 3.9k Star 与 876 次 Fork，是 Python 生态接入 Anthropic API 的主要途径。

本次更新由自动化发布工具 stainless-app 推送，并经 GitHub 验证签名确认。版本整体属于增量更新，包含一项新功能和一项维护性变更，适合希望跟进官方接口能力的团队及时升级。

新增功能：支出限额查询接口

本次最值得关注的改动，是新增了 list spend limits（支出限额列表） 的 API 端点。

对于在生产环境大规模调用大模型的团队而言，成本控制一直是运维痛点。此前开发者往往需要通过账单后台或自行统计请求量来估算花费，缺乏程序化手段实时感知配额状态。新增的支出限额查询接口意味着应用可以直接在代码层面读取当前账户或项目的限额信息，从而实现更精细的预算监控与自动告警逻辑。

对于构建多租户 SaaS 产品、需要按客户分配额度的场景，这一接口尤其实用——开发者可以把限额数据接入内部仪表盘或计费系统，避免因超额调用而产生意外费用。

Anthropic 的支出限额（Spend Limits）体系通常分为账户级（Account-level）和项目级（Project-level）两个维度。账户级限额限制整个组织在计费周期内的总消耗，而项目级限额则允许将预算分配给不同的应用或团队。在此次 SDK 更新之前，开发者若需了解剩余配额，通常只能登录 Anthropic Console 后台手动查看，或依赖 API 调用失败时返回的错误码（如 429 rate_limit_error）被动感知超限。新增的 list spend limits 接口将这一信息暴露为可编程的数据端点，使得定时轮询、阈值预警、自动降级等成本治理策略得以在应用层面原生实现，而无需借助第三方监控工具绕行。

维护性变更：弃用 Sonnet 4.5

在 Chores（日常维护）部分，本次版本标记 deprecate sonnet 4.5，即在客户端层面弃用了 Sonnet 4.5 相关配置。

模型弃用在大模型厂商的迭代节奏中属于常规操作，通常意味着该模型版本将逐步退出支持，开发者应尽早迁移到更新的模型版本。需要提醒的是，SDK 层面的 deprecate 往往是行为层面的预告，升级后若代码中仍硬编码引用了被弃用的模型标识，建议检查调用逻辑并替换为官方推荐的最新模型，以免后续出现兼容性问题。

在 Anthropic 的模型命名体系中，Claude 系列按能力层级分为 Haiku（轻量快速）、Sonnet（均衡）和 Opus（旗舰）三档，每一档都会随时间推出新一代版本。SDK 层面的"弃用"（deprecate）通常分两阶段落地：第一阶段在代码中标注废弃警告（deprecation warning），调用时控制台会输出提示但功能仍可用；第二阶段才是在 API 层面彻底下线，届时调用被弃用的模型标识符将返回错误。因此，当前收到 Sonnet 4.5 弃用信号的开发者仍有一定迁移窗口期，但建议优先将模型 ID 替换为 claude-sonnet-4（或官方文档所列的最新稳定版本），避免在 Anthropic 最终下线时出现服务中断。

升级建议

从 v1.10.0 到 v1.11.0 是一次低风险的小版本更新。对于关注成本可观测性的团队，支出限额接口是直接的升级动力；对于仍在使用较旧模型配置的项目，则应借此机会梳理模型依赖。

一般通过 pip install --upgrade anthropic 即可完成升级。建议在升级后查阅官方 Full Changelog（v1.10.0...v1.11.0），确认新接口的具体参数与返回结构，并在测试环境验证现有调用不受模型弃用影响。

小结

v1.11.0 延续了 Anthropic SDK 以自动化方式稳定迭代的风格：功能面增强了成本管理能力，维护面推进了模型版本的新陈代谢。虽然改动不大，但对于深度依赖 Claude 的工程团队来说，支出限额查询这类基础设施级接口，往往比单纯的性能提升更有实际价值。