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

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

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

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

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

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

## 版本歷史

Anthropic 建議盡可能使用最新的 API 版本。

* `2026-10-21`

  * [遷移至 API 版本 2026-10-21](https://platform.claude.com/docs/zh-TW/api/migration-2026-10-21) 說明如何升級。

  * 可在 Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)、[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/anthropic-managed)、[Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 以及 [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/google-managed) 上使用。在 [Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock) 上，適用於 Claude 4.7 及更新的模型。關於 Bedrock 上的其他模型，請參閱 [API 版本 2026-10-21 的遷移指南](https://platform.claude.com/docs/zh-TW/api/migration-2026-10-21#upgrade)。

  * Messages API：

    * 將 `document` 區塊直接放在 `assistant` 訊息中的請求會傳回 400 錯誤。
    * 在 `user` 訊息中傳送帶有非空 `citations` 陣列的 `text` 區塊（無論是直接傳送或位於 `search_result` 區塊內），都會傳回 400 錯誤。
    * `temperature`、`top_p` 和 `top_k` 請求參數已移除。傳送其中任何一個參數的請求，在所有模型上都會傳回 400 錯誤。

  * Admin API：

    * [RBAC 群組](https://platform.claude.com/docs/zh-TW/api/beta/organization/rbac_groups/list)不再傳回 `roles`。請改用 `role_ids`。
    * [RBAC 群組成員](https://platform.claude.com/docs/zh-TW/api/beta/organization/rbac_groups/members/list)以及移除成員時的回應，不再傳回 `group_id`。請改用 `rbac_group_id`。
    * [RBAC 角色](https://platform.claude.com/docs/zh-TW/api/beta/organization/rbac_roles/list)不再傳回 `name`。請改用 `display_name`。
    * [組織](https://platform.claude.com/docs/zh-TW/api/organization/rate_limits/list)和[工作區](https://platform.claude.com/docs/zh-TW/api/organization/workspaces/rate_limits/list)的「rate limit」（速率限制）項目，以及[設定工作區速率限制](https://platform.claude.com/docs/zh-TW/api/organization/workspaces/rate_limits/update)的回應，不再傳回 `group_type`。請改用 `group.type`。
    * [API 金鑰](https://platform.claude.com/docs/zh-TW/api/organization/api_keys/list)不再傳回 `workspace_id`。請改用 `scope.workspace_id`，即使是預設工作區，它也會提供工作區的真實 ID（適用於所有工作區的金鑰在 `scope` 中沒有 `workspace_id`）。

  * Claude Enterprise Analytics API：

    * 每位使用者的[用量](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics/user_usage_report/list)和[成本](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics/user_cost_report/list)報告不再包含 `actor.email`。請改用 `actor.email_address`。
    * [活動摘要](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics/summaries/list)回應不再包含 `summaries`。請改用 `data`。

* `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`：初始版本。