Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Los controles de residencia de datos te permiten gestionar dónde se procesan y almacenan tus datos. Dos configuraciones independientes gobiernan esto:
inference_geo o como valor predeterminado del workspace.El parámetro inference_geo controla dónde se ejecuta la inferencia del modelo para una solicitud de API específica. Agrégalo a cualquier llamada POST /v1/messages.
| Valor | Descripción |
|---|---|
"global" | Predeterminado. La inferencia puede ejecutarse en cualquier geografía disponible para obtener un rendimiento y disponibilidad óptimos. |
"us" | La inferencia se ejecuta únicamente en infraestructura ubicada en EE. UU. |
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)
# Verifica dónde se ejecutó realmente la inferencia
print(f"Inference geo: {response.usage.inference_geo}")El objeto usage de la respuesta incluye un campo inference_geo que indica dónde se ejecutó la inferencia:
{
"usage": {
"input_tokens": 25,
"output_tokens": 150,
"inference_geo": "us"
}
}El parámetro inference_geo es compatible con Claude 4.6 y modelos posteriores. Las solicitudes con inference_geo en Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 o modelos anteriores devuelven un error 400.
La configuración del workspace también admite restringir qué inference geos están disponibles:
allowed_inference_geos: Restringe qué geos puede usar un workspace. Si una solicitud especifica un inference_geo que no está en esta lista, la API devuelve un error.default_inference_geo: Establece el geo de respaldo cuando se omite inference_geo en una solicitud. Las solicitudes individuales pueden anular esto estableciendo inference_geo explícitamente.Estas configuraciones se pueden establecer a través de la Console o la Admin API bajo el campo data_residency.
El Workspace geo se establece cuando creas un workspace y no se puede cambiar después. Actualmente, "us" es el único workspace geo disponible.
Para establecer el workspace geo, crea un nuevo workspace en la Console:
Los precios de residencia de datos varían según la generación del modelo:
inference_geo: "us") tiene un precio de 1.1x la tarifa estándar en todas las categorías de precios de tokens (tokens de entrada, tokens de salida, escrituras de caché y lecturas de caché).inference_geo: "global"): Se aplican los precios estándar.inference_geo (consulta Disponibilidad de modelos); se aplican los precios estándar. Las solicitudes que incluyen el parámetro devuelven un error 400.Estos precios se aplican a la API de Claude (de primera parte) y a Claude Platform on AWS. En Claude in Microsoft Foundry, el mismo multiplicador de 1.1x se aplica a las implementaciones alojadas en Azure que usan el tipo de implementación US Data Zone Standard. Las plataformas operadas por socios (Bedrock y Google Cloud) tienen sus propios precios regionales. Consulta Precios de residencia de datos para obtener más detalles.
El mismo multiplicador se aplica a Claude Managed Agents: cuando la configuración del modelo de un agente fija inference_geo en "us", las solicitudes del modelo en las sesiones que ejecutan ese agente tienen un precio de 1.1x la tarifa estándar.
El parámetro inference_geo es compatible con la Batch API. Cada solicitud en un lote puede especificar su propio valor de inference_geo.
Si tu organización anteriormente optó por excluirse del enrutamiento global para mantener la inferencia en EE. UU., tu workspace se ha configurado automáticamente con allowed_inference_geos: ["us"] y default_inference_geo: "us". No se requieren cambios de código. Tus requisitos existentes de residencia de datos continúan aplicándose a través de los nuevos controles de geo.
La exclusión heredada era una configuración a nivel de organización que restringía todas las solicitudes a infraestructura ubicada en EE. UU. Los nuevos controles de residencia de datos reemplazan esto con dos mecanismos:
inference_geo te permite especificar "us" o "global" en cada llamada a la API, dándote flexibilidad a nivel de solicitud.default_inference_geo y allowed_inference_geos en la Console te permiten aplicar políticas de geo en todas las claves de un workspace.Tu workspace se migró automáticamente:
| Configuración heredada | Nuevo equivalente |
|---|---|
| Exclusión del enrutamiento global (solo EE. UU.) | allowed_inference_geos: ["us"], default_inference_geo: "us" |
Todas las solicitudes de API que usan claves de tu workspace continúan ejecutándose en infraestructura ubicada en EE. UU. No se necesita ninguna acción para mantener tu comportamiento actual.
Si tus requisitos de residencia de datos han cambiado y deseas aprovechar el enrutamiento global para obtener mejor rendimiento y disponibilidad, actualiza la configuración de inference geo de tu workspace para incluir "global" en los geos permitidos y establece default_inference_geo en "global". Consulta Restricciones a nivel de workspace para obtener más detalles.
Los modelos heredados no se ven afectados por esta migración. Para conocer los precios actuales de los modelos más nuevos, consulta Precios.
"us" y "global" están disponibles."us" está disponible actualmente. El Workspace geo no se puede cambiar después de la creación del workspace.Consulta los detalles de precios de residencia de datos.
Aprende sobre la configuración de workspaces.
Rastrea el uso y los costos por residencia de datos.
Was this page helpful?