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

  • 2023-06-01

    • 流式传输服务器发送事件(SSE)的新格式:

      • 补全内容是增量式的。例如," Hello"、" my"、" name"、" is"、" Claude." ,而不是 " Hello"、" Hello my"、" Hello my name"、" Hello my name is"、" Hello my name is Claude."。
      • 所有事件均为命名事件,而非仅数据事件。
      • 移除了不必要的 data: [DONE] 事件。
    • 移除了响应中遗留的 exception 和 truncated 值。

  • 2023-01-01:初始版本。

文档内容持续同步更新