資料駐留

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

工作區地理區域

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

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

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

定價

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

• Claude 4.6 及更新的模型： 僅限美國的推論（inference_geo: "us"）在所有權杖定價類別（輸入權杖、輸出權杖、快取寫入與快取讀取）中皆以標準費率的 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 支援

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"。工作區地理區域在工作區建立後無法變更。

後續步驟