数据驻留

"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 支持

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" 可用。工作区地理区域在工作区创建后无法更改。

后续步骤