ベータヘッダー

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

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

ベータ機能にアクセスするには、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

各機能のドキュメントには、送信すべき正確なベータ名が記載されています。API概要には、現在ベータ版のAPIが一覧表示されています。

以下の例では、コンテキスト編集ベータを例として、cURL、ant CLI、およびSDKで同じリクエストを示しています。SDKは betas パラメータでベータ名を受け取り、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)

複数のベータ機能

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

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）。

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

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

SDKの beta 名前空間はこれらのヘッダーを自動的に追加します。生のHTTPリクエストを行う場合にのみ、自分で追加してください。詳細については、Managed Agents概要、エージェントメモリの使用、およびMCPトンネルリファレンスを参照してください。

同じエンドポイントに適用されるエンドポイント固有のヘッダーは、常に組み合わせられるとは限りません。メモリストアのエンドポイントでは、agent-memory-2026-07-22 が managed-agents-2026-04-01 を置き換えます。同じリクエストで両方を送信すると 400 エラーが返されます。クライアントSDKは各エンドポイントに対して正しいヘッダーを自動的に送信します。

バージョン命名規則

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

エラー処理

無効なベータ名、または組織がアクセス権を持たないベータを使用した場合、400 エラーレスポンスが返されます。

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

サポートの利用

ベータ機能の更新情報については、リリースノートを参照してください。本番環境の問題に関するサポートについては、サポートにお問い合わせください。

次のステップ