この機能は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、Vertex AI、Microsoft Foundryでは、推論リージョンはエンドポイントURLまたは推論プロファイルによって決定されるため、inference_geoは適用されません。また、inference_geoパラメータはOpenAI SDK互換エンドポイント経由では利用できません。
ワークスペース設定では、利用可能な推論ジオの制限もサポートされています。
allowed_inference_geos: ワークスペースが使用できるジオを制限します。リクエストでこのリストにないinference_geoが指定された場合、APIはエラーを返します。default_inference_geo: リクエストでinference_geoが省略された場合のフォールバックジオを設定します。個々のリクエストは、inference_geoを明示的に設定することでこれを上書きできます。これらの設定は、ConsoleまたはAdmin APIのdata_residencyフィールドを通じて設定できます。
Workspace geoはワークスペースの作成時に設定され、後から変更することはできません。現在、利用可能なワークスペースジオは"us"のみです。
Workspace geoを設定するには、Consoleで新しいワークスペースを作成します。
Claude Platform on AWS: Workspace geoは設定できません。ワークスペースはAWS Consoleを通じてプロビジョニングされ、Claude ConsoleのWorkspacesページは読み取り専用です。このプラットフォーム上のClaude Managed Agentsセッションは、実質的なWorkspace geoとして"us"で実行されます。これは現在利用可能な唯一のワークスペースジオです。そのプラットフォーム固有のデータレジデンシーに関する考慮事項については、Claude Platform on AWSを参照してください。
データレジデンシーの料金は、モデルの世代によって異なります。
inference_geo: "us")は、すべてのトークン料金カテゴリ(入力トークン、出力トークン、キャッシュ書き込み、キャッシュ読み取り)において標準料金の1.1倍で課金されます。inference_geo: "global"):標準料金が適用されます。inference_geoをサポートしていません(モデルの対応状況を参照)。標準料金が適用されます。このパラメータを含むリクエストは400エラーを返します。この料金は、Claude API(ファーストパーティ)およびClaude Platform on AWSに適用されます。パートナー運営のプラットフォーム(BedrockおよびVertex AI)には独自のリージョン料金があります。詳細については、データレジデンシー料金を参照してください。
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リクエストは、引き続き米国ベースのインフラストラクチャで実行されます。現在の動作を維持するために必要なアクションはありません。
データレジデンシー要件が変更され、パフォーマンスと可用性の向上のためにグローバルルーティングを活用したい場合は、ワークスペースの推論ジオ設定を更新して、許可されたジオに"global"を含め、default_inference_geoを"global"に設定してください。詳細については、ワークスペースレベルの制限を参照してください。
従来のモデルはこの移行の影響を受けません。新しいモデルの現在の料金については、料金を参照してください。
"us"と"global"のみが利用可能です。"us"のみが利用可能です。Workspace geoはワークスペース作成後に変更できません。Was this page helpful?