この機能はZero Data Retention(ZDR)の対象です。組織がZDR契約を締結している場合、この機能を通じて送信されたデータは、APIレスポンスが返された後に保存されることはありません。
データレジデンシーコントロールを使用すると、データの処理場所と保存場所を管理できます。これは、2つの独立した設定によって制御されます。
inference_geo APIパラメータを通じて、またはワークスペースのデフォルトとして設定します。Claude Managed Agentsはinference_geoパラメータをサポートしていませんが、Consoleで設定されたWorkspace geoは尊重されます。セルフホスト型サンドボックスを使用すると、ツール実行とサンドボックスのファイルシステムは、お客様が管理するインフラストラクチャ上に留まります。
inference_geoパラメータは、特定のAPIリクエストに対してモデル推論が実行される場所を制御します。任意のPOST /v1/messages呼び出しに追加してください。
| 値 | 説明 |
|---|---|
"global" | デフォルト。最適なパフォーマンスと可用性のために、利用可能な任意の地域で推論が実行される可能性があります。 |
"us" | 推論は米国ベースのインフラストラクチャでのみ実行されます。 |
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
inference_geo="us",
messages=[
{"role": "user", "content": "Summarize the key points of this document."}
],
)
print(response.content[0].text)
# 推論が実際に実行された場所を確認
print(f"Inference geo: {response.usage.inference_geo}")レスポンスのusageオブジェクトには、推論が実行された場所を示すinference_geoフィールドが含まれます。
{
"usage": {
"input_tokens": 25,
"output_tokens": 150,
"inference_geo": "us"
}
}inference_geoパラメータは、Claude Opus 4.6、Claude Sonnet 4.6、およびそれ以降のモデルでサポートされています。Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5、またはそれ以前のモデルでinference_geoを指定したリクエストは、400エラーを返します。
inference_geoパラメータは、Claude API(ファーストパーティ)およびClaude Platform on AWSで利用可能です。Amazon BedrockおよびGoogle Cloudでは、推論リージョンはエンドポイントURLまたは推論プロファイルによって決定されるため、inference_geoは適用されません。Claude in Microsoft Foundryでも同様にinference_geoは適用されません。Azureでホストされているデプロイメントでは、代わりにUS Data Zone Standardデプロイメントタイプを使用でき、これにより推論が米国内に留まります。また、inference_geoパラメータはOpenAI SDK互換エンドポイント経由では利用できません。
ワークスペース設定では、利用可能なinference geoの制限もサポートしています。
allowed_inference_geos: ワークスペースが使用できるジオを制限します。リクエストがこのリストにないinference_geoを指定した場合、APIはエラーを返します。default_inference_geo: リクエストでinference_geoが省略された場合のフォールバックジオを設定します。個々のリクエストは、inference_geoを明示的に設定することでこれを上書きできます。これらの設定は、ConsoleまたはAdmin APIのdata_residencyフィールドを通じて設定できます。
Workspace geoはワークスペースの作成時に設定され、後から変更することはできません。現在、利用可能なworkspace geoは"us"のみです。
Workspace geoを設定するには、Consoleで新しいワークスペースを作成します。
Claude Platform on AWS: Workspace geoは設定できません。ワークスペースはAWS Consoleを通じてプロビジョニングされ、Claude ConsoleのWorkspacesページは読み取り専用です。このプラットフォーム上のClaude Managed Agentsセッションは、実質的なWorkspace geoが"us"として実行されます。これは現在利用可能な唯一のworkspace geoです。このプラットフォーム固有のデータレジデンシーに関する考慮事項については、Claude Platform on AWSを参照してください。
データレジデンシーの料金は、モデルの世代によって異なります。
inference_geo: "us")は、すべてのトークン料金カテゴリ(入力トークン、出力トークン、キャッシュ書き込み、キャッシュ読み取り)において標準料金の1.1倍で課金されます。inference_geo: "global"):標準料金が適用されます。inference_geoをサポートしていません(モデルの利用可能性を参照)。標準料金が適用されます。このパラメータを含むリクエストは400エラーを返します。この料金は、Claude API(ファーストパーティ)およびClaude Platform on AWSに適用されます。Claude in Microsoft Foundryでは、US Data Zone Standardデプロイメントタイプを使用するAzureでホストされたデプロイメントに同じ1.1倍の乗数が適用されます。パートナー運営のプラットフォーム(BedrockおよびGoogle Cloud)には、独自のリージョン料金があります。詳細については、データレジデンシーの料金を参照してください。
Priority Tierのコミットメントがある場合、米国のみの推論に対する1.1倍の乗数は、Priority Tierの容量に対するトークンのカウント方法にも影響します。inference_geo: "us"で消費される各トークンは、コミットされたTPMから1.1トークン分を消費します。これは、他の料金乗数(プロンプトキャッシングなど)がバーンダウンレートに影響する方法と一貫しています。
inference_geoパラメータはBatch APIでサポートされています。バッチ内の各リクエストは、独自のinference_geo値を指定できます。
推論を米国内に留めるために、組織が以前にグローバルルーティングをオプトアウトしていた場合、ワークスペースは自動的にallowed_inference_geos: ["us"]およびdefault_inference_geo: "us"で設定されています。コードの変更は不要です。既存のデータレジデンシー要件は、新しいジオコントロールを通じて引き続き適用されます。
レガシーオプトアウトは、すべてのリクエストを米国ベースのインフラストラクチャに制限する組織レベルの設定でした。新しいデータレジデンシーコントロールは、これを2つのメカニズムに置き換えます。
inference_geoパラメータにより、各API呼び出しで"us"または"global"を指定でき、リクエストレベルの柔軟性が得られます。default_inference_geoおよびallowed_inference_geos設定により、ワークスペース内のすべてのキーにわたってジオポリシーを適用できます。ワークスペースは自動的に移行されました。
| レガシー設定 | 新しい同等設定 |
|---|---|
| グローバルルーティングのオプトアウト(米国のみ) | allowed_inference_geos: ["us"]、default_inference_geo: "us" |
ワークスペースのキーを使用するすべてのAPIリクエストは、引き続き米国ベースのインフラストラクチャで実行されます。現在の動作を維持するためのアクションは不要です。
データレジデンシー要件が変更され、パフォーマンスと可用性を向上させるためにグローバルルーティングを活用したい場合は、ワークスペースのinference geo設定を更新して、許可されたジオに"global"を含め、default_inference_geoを"global"に設定してください。詳細については、ワークスペースレベルの制限を参照してください。
レガシーモデルはこの移行の影響を受けません。新しいモデルの現在の料金については、料金を参照してください。
"us"と"global"のみが利用可能です。"us"のみが利用可能です。Workspace geoはワークスペース作成後に変更できません。Was this page helpful?