Claude Platform Docs
API リファレンスAPI の使用

ベータヘッダー

anthropic-beta ヘッダーまたはSDKの betas パラメータを使用して、標準APIの一部になる前の実験的機能にアクセスします。

ベータヘッダー（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=["feature1", "feature2"]）。CLIでは、機能名をカンマで区切って単一の --beta フラグに渡します（例：--beta feature1,feature2）。フラグを繰り返し指定することもできます（例：--beta feature1 --beta feature2）。

他のプラットフォームでのベータ機能

ベータ名はそれを受け付けるすべてのプラットフォームで同じですが、すべてのプラットフォームがすべてのベータを受け付けるわけではありません。Claude Platform on AWS、Microsoft Foundry、およびGoogle Cloudは、Claude APIと同様に anthropic-beta ヘッダーでベータ名を受け取ります。複数のベータを送信するには、それらの名前をカンマで区切って1つのヘッダーに入れてください。Google Cloudは anthropic-beta ヘッダーを1つだけ読み取り、残りは無視するため、他のヘッダーに含まれるベータは有効になりません。

Amazon Bedrockでは、ベータ名を指定する場所は呼び出すAPIによって異なります：

  • Claude in Amazon Bedrock（bedrock-mantle エンドポイント）は、anthropic-beta ヘッダーでベータ名を受け取ります。
  • InvokeModel APIは、ヘッダーではなくリクエストボディからベータ名を読み取ります。ボディの anthropic_beta 配列に、1要素につき1つの名前で列挙してください。例："anthropic_beta": ["feature1", "feature2"]。

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

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

エンドポイントベータヘッダー
/v1/agents、/v1/sessions、/v1/environmentsmanaged-agents-2026-04-01
/v1/tunnelsmcp-tunnels-2026-06-22
/v1/memory_stores およびサブリソースagent-memory-2026-07-22

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

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

バージョン命名規則

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

エラー処理

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

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

サポートの利用

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

次のステップ

エラー

Claude APIが返すHTTPステータスコード、エラーレスポンスの形式、リクエストIDを理解し、SDKの型付き例外でエラーを処理します。

API概要

現在ベータ版のAPIを含む、Claude APIの機能を確認します。

Was this page helpful?