ベータヘッダー

ベータヘッダーを使用すると、実験的な機能や新しいモデルの機能を標準APIの一部になる前にアクセスすることができます。

これらの機能は変更される可能性があり、将来のリリースで修正または削除される場合があります。

​

ベータヘッダーの使用方法

ベータ機能にアクセスするには、APIリクエストにanthropic-betaヘッダーを含めてください：

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

SDKを使用する場合、リクエストオプションでベータヘッダーを指定できます：

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"
    }
)

​

複数のベータ機能

1つのリクエストで複数のベータ機能を使用するには、カンマで区切ってすべての機能名をヘッダーに含めてください：

anthropic-beta: feature1,feature2,feature3

​

バージョン命名規則

ベータ機能名は通常、feature-name-YYYY-MM-DDというパターンに従います。日付はベータバージョンがリリースされた日を示します。必ずドキュメントに記載されている正確なベータ機能名を使用してください。

​

エラー処理

無効または利用できないベータヘッダーを使用した場合、以下のようなエラーレスポンスが返されます：

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

​

サポートを受ける

ベータ機能に関する質問については：

1. 特定の機能のドキュメントを確認する
2. 更新情報についてはAPIの変更履歴を確認する
3. 本番環境での使用についてはサポートに問い合わせる

ベータ機能は「現状のまま」提供され、安定版APIの機能と同じSLA保証がない場合があることにご注意ください。