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

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

如何使用 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.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "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 保證。