Residencia de datos

Los controles de "data residency" (residencia de datos) te permiten administrar dónde se procesan y almacenan tus datos. Dos configuraciones independientes rigen esto:

• Inference geo (geografía de inferencia): Controla dónde se ejecuta la inferencia del modelo, por solicitud. Se establece mediante el parámetro de API inference_geo o como valor predeterminado del workspace.
• Workspace geo (geografía del workspace): Controla dónde se almacenan los datos en reposo y dónde ocurre el procesamiento de endpoints (como la transcodificación de imágenes y la ejecución de código). Se configura a nivel de workspace en la Claude Console.

Inference geo

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.

Uso de la 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)
# Verifica dónde se ejecutó realmente la inferencia
print(f"Inference geo: {response.usage.inference_geo}")

Respuesta

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"
  }
}

Disponibilidad de modelos

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.

Restricciones a nivel de workspace

La configuración del workspace también permite restringir qué geografías de inferencia están disponibles:

• allowed_inference_geos: Restringe qué geografías 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 la geografía 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.

Workspace geo

La Workspace geo se establece cuando creas un workspace y no se puede cambiar después. Actualmente, "us" es la única Workspace geo disponible.

Para establecer la Workspace geo, crea un nuevo workspace en la Console:

1. Ve a Settings > Workspaces.
2. Crea un nuevo workspace.
3. Selecciona la Workspace geo.

Precios

Los precios de residencia de datos varían según la generación del modelo:

• Claude 4.6 y modelos posteriores: La inferencia solo en EE. UU. (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 en caché y lecturas de caché).
• Enrutamiento global (inference_geo: "global"): Se aplican los precios estándar.
• Modelos anteriores: No admiten 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 Claude API (de primera parte) y a Claude Platform on AWS. En Claude en 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 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.

Compatibilidad con la Batch API

El parámetro inference_geo es compatible con la Batch API. Cada solicitud en un lote puede especificar su propio valor de inference_geo.

Migración desde las exclusiones heredadas

Si tu organización optó anteriormente 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 en el código. Tus requisitos de residencia de datos existentes siguen aplicándose a través de los nuevos controles geográficos.

Qué cambió

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 la reemplazan con dos mecanismos:

• Control por solicitud: El parámetro inference_geo te permite especificar "us" o "global" en cada llamada a la API, lo que te da flexibilidad a nivel de solicitud.
• Controles de workspace: Las configuraciones default_inference_geo y allowed_inference_geos en la Console te permiten aplicar políticas geográficas en todas las claves de un workspace.

Qué pasó con tu workspace

Tu workspace se migró automáticamente:

Todas las solicitudes de API que usan claves de tu workspace siguen ejecutándose en infraestructura ubicada en EE. UU. No se necesita ninguna acción para mantener tu comportamiento actual.

Si quieres usar el enrutamiento global

Si tus requisitos de residencia de datos han cambiado y quieres aprovechar el enrutamiento global para obtener mejor rendimiento y disponibilidad, actualiza la configuración de geografía de inferencia de tu workspace para incluir "global" en las geografías permitidas y establece default_inference_geo en "global". Consulta Restricciones a nivel de workspace para más detalles.

Impacto en los precios

Los modelos heredados no se ven afectados por esta migración. Para conocer los precios actuales de los modelos más recientes, consulta Precios.

Limitaciones actuales

• Límites de velocidad compartidos: Los límites de velocidad se comparten entre todas las geografías.
• Inference geo: Solo están disponibles "us" y "global".
• Workspace geo: Actualmente solo está disponible "us". La Workspace geo no se puede cambiar después de crear el workspace.

Próximos pasos