Claude Platform Docs
API 參考使用 API

Beta 標頭

透過 anthropic-beta 標頭或 SDK 的 betas 參數，在實驗性功能成為標準 API 的一部分之前搶先使用。

「Beta headers」（Beta 標頭）讓您能夠在實驗性功能與新的模型能力成為標準 API 的一部分之前搶先使用。

如何使用 beta 標頭

若要使用 beta 功能，請在您的 API 請求中加入 anthropic-beta 標頭：

POST /v1/messages
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

每項功能的文件都會說明要傳送的確切 beta 名稱。API 概覽列出了目前處於 beta 階段的 API。

以下範例以 context editing（上下文編輯）beta 為例，展示使用 cURL、ant CLI 與 SDK 發送相同請求的方式。SDK 會透過 betas 參數接收 beta 名稱，並為您傳送 anthropic-beta 標頭：

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["context-management-2025-06-27"],
)

print(response.content)

多項 beta 功能

若要在單一請求中使用多項 beta 功能，請在標頭中加入所有功能名稱，並以逗號分隔：

anthropic-beta: feature1,feature2,feature3

您也可以在同一個請求中多次傳送 anthropic-beta 標頭。Claude API 會讀取每一個 anthropic-beta 標頭，因此以下內容與前一個範例等效：

anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3

使用 SDK 時，請在 betas 參數中列出每項功能（例如 betas=["feature1", "feature2"]）。使用 CLI 時，請傳遞單一 --beta 旗標，並以逗號分隔功能名稱（例如 --beta feature1,feature2）。您也可以重複使用該旗標（例如 --beta feature1 --beta feature2）。

端點專屬標頭

部分 beta API 的範圍限定於特定端點，且每次請求都需要附上該功能專屬的 beta 標頭：

端點Beta 標頭
/v1/agents、/v1/sessions、/v1/environmentsmanaged-agents-2026-04-01
/v1/tunnelsmcp-tunnels-2026-06-22
/v1/memory_stores 及其子資源agent-memory-2026-07-22

SDK 的 beta 命名空間會自動加入這些標頭。只有在發送原始 HTTP 請求時，您才需要自行加入。詳情請參閱 Managed Agents 概覽、使用代理記憶以及 MCP tunnels 參考文件。

適用於同一端點的端點專屬標頭不一定能夠組合使用。在記憶儲存庫端點上，agent-memory-2026-07-22 會取代 managed-agents-2026-04-01：在同一請求中同時傳送兩者會回傳 400 錯誤。用戶端 SDK 會自動為每個端點傳送正確的標頭。

版本命名慣例

Beta 功能名稱通常遵循 feature-name-YYYY-MM-DD 的格式，其中日期表示該 beta 的發布時間。請務必使用文件中記載的確切 beta 功能名稱。

錯誤處理

如果您使用了無效的 beta 名稱，或是您的組織無權存取的 beta，您將收到 400 錯誤回應：

Output
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header."
  },
  "request_id": "req_011CcnGfC9fELffo2EALu4Wd"
}

取得協助

如需 beta 功能的更新資訊，請參閱版本說明。如需正式環境問題的協助，請聯繫支援團隊。

後續步驟

錯誤

了解 Claude API 回傳的 HTTP 狀態碼、錯誤回應格式與請求 ID，並使用 SDK 的型別化例外來處理錯誤。

API 概覽

探索 Claude API 的功能，包括目前處於 beta 階段的 API。

Was this page helpful?