ベータヘッダー

ベータヘッダーを使用すると、実験的な機能や新しいモデル機能が標準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",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)

print(response.content)



複数のベータ機能

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

anthropic-beta: feature1,feature2,feature3

SDKを使用する場合は、betasパラメータに各機能をリストします（例：betas=["feature1", "feature2"]）。CLIでは、機能名をカンマで区切った単一の--betaフラグを渡します（例：--beta feature1,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"
}



ヘルプの利用

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



次のステップ