資料駐留

資料駐留控制讓您管理資料處理和儲存的位置。兩個獨立的設定控制此功能：

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

推論地理位置

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

API 使用方式

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 1024,
        "inference_geo": "us",
        "messages": [{
            "role": "user",
            "content": "Summarize the key points of this document."
        }]
    }'

回應

回應的 usage 物件包含一個 inference_geo 欄位，指示推論執行的位置：

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}

模型可用性

inference_geo 參數支援 Claude Opus 4.6 及所有後續模型。在 Opus 4.6 之前發布的舊模型不支援此參數。在舊模型上使用 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 Opus 4.6 及更新版本：僅限美國推論（inference_geo: "us"）在所有 token 定價類別（輸入 token、輸出 token、快取寫入和快取讀取）中以標準費率的 1.1 倍計價。
• 全球路由（inference_geo: "global" 或省略）：適用標準定價。
• 舊模型：無論 inference_geo 設定如何，現有定價保持不變。

此定價僅適用於 Claude API（1P）。第三方平台（AWS Bedrock、Google Vertex AI、Microsoft Foundry）有各自的區域定價。詳情請參閱定價頁面。

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"。詳情請參閱工作區層級限制。

定價影響

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

目前限制

• 共享速率限制：速率限制在所有地理位置之間共享。
• 推論地理位置：啟動時僅提供 "us" 和 "global"。將隨時間新增更多區域。
• 工作區地理位置：目前僅提供 "us"。工作區地理位置在工作區建立後無法變更。

後續步驟