Beta 標頭允許您在實驗性功能和新模型能力成為標準 API 的一部分之前就能存取它們。

這些功能可能會有所變更,並可能在未來版本中被修改或移除。

Beta 標頭通常與客戶端 SDK 中的 beta 命名空間一起使用

如何使用 beta 標頭

要存取 beta 功能,請在您的 API 請求中包含 anthropic-beta 標頭:

POST /v1/messages
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

使用 SDK 時,您可以在請求選項中指定 beta 標頭:

from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)

Beta 功能是實驗性的,可能會:

  • 在沒有通知的情況下發生重大變更
  • 被棄用或移除
  • 有不同的速率限制或定價
  • 不在所有地區提供

多個 beta 功能

要在單一請求中使用多個 beta 功能,請在標頭中包含所有功能名稱,並用逗號分隔:

anthropic-beta: feature1,feature2,feature3

版本命名慣例

Beta 功能名稱通常遵循模式:feature-name-YYYY-MM-DD,其中日期表示 beta 版本發布的時間。請始終使用文件中記錄的確切 beta 功能名稱。

錯誤處理

如果您使用無效或不可用的 beta 標頭,您將收到錯誤回應:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}

獲得協助

有關 beta 功能的問題:

  1. 查看特定功能的文件
  2. 查看 API 變更日誌以獲取更新
  3. 聯繫支援以獲得生產使用的協助

請記住,beta 功能是「按現狀」提供的,可能沒有與穩定 API 功能相同的 SLA 保證。