API 版本
在发出 API 请求时,您必须发送 `anthropic-version` 请求头。例如,`anthropic-version: 2026-10-21`。如果您使用的是[客户端 SDK](/docs/cli-sdks-libraries/overview),它会为您设置此请求头。
对于任何给定的 API 版本,Anthropic 会保留:
- 现有的输入参数
- 现有的输出参数
但是,Anthropic 可能会执行以下操作:
- 添加额外的可选输入
- 向输出中添加额外的值
- 更改特定错误类型的触发条件
- 向类枚举的输出值添加新的变体(例如,流式传输事件类型)
一般而言,如果您按照本参考文档中所述的方式使用 API,Anthropic 不会破坏您的使用方式。
版本历史
Anthropic 建议尽可能使用最新的 API 版本。
-
2026-10-21-
迁移到 API 版本 2026-10-21 介绍了如何升级。
-
可在 Claude API、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed)、Claude Models on Google Cloud (Google managed) 和 Microsoft Foundry 上使用。在 Amazon Bedrock 上,它适用于 Claude 4.7 及更高版本的模型。对于 Bedrock 上较早的 Claude 模型,请继续使用您当前使用的 API 版本。
-
Messages API:
- 将
document块直接放在assistant消息中的请求会返回 400 错误。 - 在
user消息中发送带有非空citations数组的text块(无论是直接发送还是放在search_result块内)都会返回 400 错误。 temperature、top_p和top_k请求参数已被移除。发送其中任何一个参数的请求在所有模型上都会返回 400 错误。
- 将
-
Admin API:
- RBAC 组不再返回
roles。请改用role_ids。 - RBAC 组成员以及移除成员时的响应不再返回
group_id。请改用rbac_group_id。 - RBAC 角色不再返回
name。请改用display_name。 - 组织和工作区的速率限制条目,以及设置工作区速率限制的响应,不再返回
group_type。请改用group.type。 - API 密钥不再返回
workspace_id。请改用scope.workspace_id。它包含密钥所属工作区的 ID,包括默认工作区(Default Workspace)。适用于所有工作区的密钥没有scope.workspace_id。
- RBAC 组不再返回
-
Claude Enterprise Analytics API:
-
-
2023-06-01 -
2023-01-01:初始版本。
文档内容持续同步更新