---
title: 版本
url: https://platform.claude.com/docs/zh-TW/api/versioning
description: "發出 API 請求時，您必須傳送 `anthropic-version` 請求標頭。例如，`anthropic-version: 2023-06-01`。如果您使用的是[用戶端 SDK](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/overview)，這會自動為您處理。"
---

對於 Messages API 的任何特定版本，Anthropic 會保留：

* 現有的輸入參數
* 現有的輸出參數

然而，Anthropic 可能會進行以下操作：

* 新增額外的選用輸入
* 在輸出中新增額外的值
* 變更特定錯誤類型的條件
* 為類似列舉的輸出值新增新的變體（例如，串流事件類型）

一般而言，如果您依照本參考文件所記載的方式使用 API，Anthropic 不會破壞您的使用方式。

## 版本歷史

Anthropic 建議盡可能使用最新的 API 版本。先前的版本被視為已棄用，且可能無法供新使用者使用。

* `2023-06-01`

  * [串流](https://platform.claude.com/docs/zh-TW/build-with-claude/streaming)「server-sent events」（伺服器傳送事件），即 SSE 的新格式：

    * 補全內容為增量式。例如，`" 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`：初始版本。