データレジデンシー制御により、データが処理および保存される場所を管理できます。これは2つの独立した設定によって制御されます。
inference_geo APIパラメータを通じて、またはワークスペースのデフォルトとして設定します。inference_geoパラメータは、特定のAPIリクエストに対してモデル推論が実行される場所を制御します。任意のPOST /v1/messages呼び出しに追加してください。
| 値 | 説明 |
|---|---|
"global" | デフォルト。最適なパフォーマンスと可用性のために、利用可能な任意の地理で推論が実行される可能性があります。 |
"us" | 推論は米国ベースのインフラストラクチャでのみ実行されます。 |
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
inference_geo="us",
messages=[
{"role": "user", "content": "Summarize the key points of this document."}
],
)
for block in response.content:
if block.type == "text":
print(block.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 4.6以降のモデルでサポートされています。Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5、またはそれ以前のモデルでinference_geoを指定したリクエストは400エラーを返します。
ワークスペース設定では、利用可能な推論ジオの制限もサポートしています。
allowed_inference_geos: ワークスペースが使用できるジオを制限します。リクエストがこのリストにないinference_geoを指定した場合、APIはエラーを返します。default_inference_geo: リクエストでinference_geoが省略された場合のフォールバックジオを設定します。個々のリクエストは、inference_geoを明示的に設定することでこれをオーバーライドできます。これらの設定は、ConsoleまたはAdmin APIのdata_residencyフィールドを通じて設定できます。
ワークスペースジオはワークスペース作成時に設定され、その後は変更できません。現在、利用可能なワークスペースジオは"us"のみです。
ワークスペースジオを設定するには、Consoleで新しいワークスペースを作成します。
データレジデンシーの料金はモデル世代によって異なります。
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)には独自のリージョン料金があります。詳細については、データレジデンシー料金を参照してください。
同じ乗数がClaude Managed Agentsにも適用されます。エージェントのモデル設定でinference_geoを"us"に固定すると、そのエージェントを実行するセッションのモデルリクエストは標準料金の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"のみが利用可能です。ワークスペースジオはワークスペース作成後に変更できません。Was this page helpful?