ベータヘッダー

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

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



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

ベータ機能にアクセスするには、APIリクエストにanthropic-betaヘッダーを含めます。

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

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

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)



複数のベータ機能

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

anthropic-beta: feature1,feature2,feature3



エンドポイント固有のヘッダー

一部のベータ機能は、個々のリクエストパラメータではなく特定のエンドポイントにスコープされており、すべてのリクエストで機能固有のベータヘッダーが必要です。

詳細については、Managed Agentsの概要を参照してください。



バージョン命名規則

ベータ機能名は通常、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保証がない場合があることにご注意ください。