---
title: 版本
url: https://platform.claude.com/docs/zh-CN/api/versioning
description: "在发出 API 请求时，您必须发送 `anthropic-version` 请求头。例如，`anthropic-version: 2023-06-01`。如果您使用的是[客户端 SDK](https://platform.claude.com/docs/zh-CN/cli-sdks-libraries/overview)，这将自动为您处理。"
---

对于 Messages API 的任何给定版本，Anthropic 会保留：

* 现有的输入参数
* 现有的输出参数

但是，Anthropic 可能会执行以下操作：

* 添加额外的可选输入
* 向输出中添加额外的值
* 更改特定错误类型的触发条件
* 向类枚举的输出值添加新的变体（例如，流式传输事件类型）

一般而言，如果您按照本参考文档中所述的方式使用 API，Anthropic 不会破坏您的使用方式。

## 版本历史

Anthropic 建议尽可能使用最新的 API 版本。以前的版本被视为已弃用，并且可能对新用户不可用。

* `2023-06-01`

  * "streaming"（流式传输）服务器发送事件（SSE）的新格式，详见[流式传输](https://platform.claude.com/docs/zh-CN/build-with-claude/streaming)：

    * 补全内容是增量式的。例如，`" Hello"`、`" my"`、`" name"`、`" is"`、`" Claude." `，而不是 `" Hello"`、`" Hello my"`、`" Hello my name"`、`" Hello my name is"`、`" Hello my name is Claude."`。
    * 所有事件均为[命名事件](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents)，而非[仅数据事件](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages)。
    * 移除了不必要的 `data: [DONE]` 事件。

  * 移除了响应中遗留的 `exception` 和 `truncated` 值。

* `2023-01-01`：初始版本。