データレジデンシー
地理的な制御により、モデル推論が実行される場所とデータが保存される場所を管理します。
「data residency」(データレジデンシー)制御により、データが処理および保存される場所を管理できます。これは2つの独立した設定によって管理されます。
- Inference geo(推論ジオ): モデル推論が実行される場所をリクエストごとに制御します。
inference_geoAPIパラメータを通じて、またはワークスペースのデフォルトとして設定します。 - Workspace geo(ワークスペースジオ): 保存データが格納される場所と、エンドポイント処理(画像のトランスコードやコード実行など)が行われる場所を制御します。Claude Consoleでワークスペースレベルで設定します。
推論ジオ
inference_geoパラメータは、特定のAPIリクエストに対してモデル推論が実行される場所を制御します。任意のPOST /v1/messages呼び出しに追加できます。
| 値 | 説明 |
|---|---|
"global" | デフォルト。最適なパフォーマンスと可用性のために、推論は利用可能な任意の地域で実行される場合があります。 |
"us" | 推論は米国ベースのインフラストラクチャでのみ実行されます。 |
APIの使用方法
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で新しいワークスペースを作成します。
- Settings > Workspacesに移動します。
- 新しいワークスペースを作成します。
- ワークスペースジオを選択します。
料金
データレジデンシーの料金はモデルの世代によって異なります。
- Claude 4.6以降のモデル: 米国限定の推論(
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倍で課金されます。
Batch APIのサポート
inference_geoパラメータはBatch APIでサポートされています。バッチ内の各リクエストは独自のinference_geo値を指定できます。
レガシーオプトアウトからの移行
組織が以前に推論を米国内に留めるためにグローバルルーティングをオプトアウトしていた場合、ワークスペースは自動的にallowed_inference_geos: ["us"]およびdefault_inference_geo: "us"で設定されています。コードの変更は必要ありません。既存のデータレジデンシー要件は、新しいジオ制御を通じて引き続き適用されます。
変更点
レガシーオプトアウトは、すべてのリクエストを米国ベースのインフラストラクチャに制限する組織レベルの設定でした。新しいデータレジデンシー制御は、これを2つのメカニズムに置き換えます。
- リクエストごとの制御:
inference_geoパラメータにより、各API呼び出しで"us"または"global"を指定でき、リクエストレベルの柔軟性が得られます。 - ワークスペース制御: Consoleの
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?