資料落地

「Data residency」（資料落地）控制讓您管理資料處理和儲存的位置。由兩個獨立的設定來管理：

• Inference geo（推論地理區域）： 以每個請求為基礎，控制模型推論執行的位置。透過 inference_geo API 參數設定，或作為工作區預設值。
• Workspace geo（工作區地理區域）： 控制靜態資料儲存的位置以及端點處理（例如影像轉碼和程式碼執行）發生的位置。在 Claude Console 中於工作區層級進行設定。



推論地理區域

inference_geo 參數控制特定 API 請求的模型推論執行位置。將其加入任何 POST /v1/messages 呼叫中。



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 欄位進行設定。



工作區地理區域

Workspace geo 在您建立工作區時設定，之後無法變更。目前，"us" 是唯一可用的工作區地理區域。

若要設定工作區地理區域，請在 Console 中建立新的工作區：

1. 前往 Settings > Workspaces。
2. 建立新的工作區。
3. 選擇工作區地理區域。



定價

資料落地定價依模型世代而異：

• Claude 4.6 及更新的模型： 僅限美國的推論（inference_geo: "us"）在所有 token 定價類別（input tokens、output tokens、快取寫入和快取讀取）中均以標準費率的 1.1 倍計價。
• 全球路由（inference_geo: "global"）：適用標準定價。
• 較舊的模型： 不支援 inference_geo（請參閱模型可用性）；適用標準定價。包含此參數的請求會回傳 400 錯誤。

此定價適用於 Claude API（第一方）和 Claude Platform on AWS。在 Claude in Microsoft Foundry 上，相同的 1.1 倍乘數適用於託管在 Azure 上且使用 US Data Zone Standard 部署類型的部署。合作夥伴營運的平台（Bedrock 和 Google Cloud）有其自己的區域定價。詳情請參閱資料落地定價。



Batch API 支援

Batch API 支援 inference_geo 參數。批次中的每個請求都可以指定自己的 inference_geo 值。



從舊版選擇退出機制遷移

如果您的組織先前選擇退出全球路由以將推論保留在美國，您的工作區已自動設定為 allowed_inference_geos: ["us"] 和 default_inference_geo: "us"。不需要變更任何程式碼。您現有的資料落地需求會繼續透過新的地理區域控制來強制執行。



有什麼改變

舊版的選擇退出機制是一個組織層級的設定，將所有請求限制在美國境內的基礎設施上。新的資料落地控制以兩種機制取代了它：

• 每個請求的控制： inference_geo 參數讓您在每次 API 呼叫時指定 "us" 或 "global"，為您提供請求層級的彈性。
• 工作區控制： Console 中的 default_inference_geo 和 allowed_inference_geos 設定讓您在工作區中的所有金鑰上強制執行地理區域政策。



您的工作區發生了什麼

您的工作區已自動遷移：

所有使用您工作區金鑰的 API 請求會繼續在美國境內的基礎設施上執行。不需要採取任何行動即可維持您目前的行為。



如果您想使用全球路由

如果您的資料落地需求已改變，且您想利用全球路由以獲得更好的效能和可用性，請更新您工作區的推論地理區域設定，在允許的地理區域中加入 "global"，並將 default_inference_geo 設為 "global"。詳情請參閱工作區層級限制。



定價影響

舊版模型不受此遷移影響。有關較新模型的目前定價，請參閱定價。



目前的限制

• 共用速率限制： 速率限制在所有地理區域之間共用。
• 推論地理區域： 僅提供 "us" 和 "global"。
• 工作區地理區域： 目前僅提供 "us"。工作區地理區域在工作區建立後無法變更。



後續步驟