資料駐留

資料駐留控制讓您能夠管理資料的處理與儲存位置。這由兩個獨立的設定所控管：

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



Inference geo（推論地理位置）

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（工作區地理位置）

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

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

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



定價

資料駐留定價因模型世代而異：

• Claude 4.6 及更新版本的模型： 僅限美國的推論（inference_geo: "us"）在所有 token 定價類別（輸入 token、輸出 token、快取寫入和快取讀取）中，定價為標準費率的 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）有各自的區域定價。詳情請參閱資料駐留定價。

相同的乘數也適用於 Claude Managed Agents：當代理程式的模型設定將 inference_geo 固定為 "us" 時，執行該代理程式的工作階段中的模型請求會以標準費率的 1.1 倍計價。



Batch API 支援

inference_geo 參數支援 Batch API。批次中的每個請求都可以指定自己的 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"。詳情請參閱工作區層級限制。



定價影響

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



目前的限制

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



後續步驟