Residencia de datos

Los controles de residencia de datos te permiten gestionar dónde se procesan y almacenan tus datos. Dos configuraciones independientes rigen esto:

• Inference geo: Controla dónde se ejecuta la inferencia del modelo, por cada solicitud. Se establece mediante el parámetro de API inference_geo o como valor predeterminado del workspace.
• Workspace geo: 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-4-8",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

print(response.content[0].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 Opus 4.6, Claude Sonnet 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é 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.

Workspace geo

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:

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

Precios

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

• Claude Opus 4.6, Claude Sonnet 4.6 y 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 API de Claude (de primera parte) y a Claude Platform on AWS. Las plataformas operadas por socios (Bedrock y Vertex AI) tienen sus propios precios regionales. Consulta Precios de residencia de datos para obtener más detalles.

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 exclusiones heredadas

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 en el código. Tus requisitos existentes de residencia de datos continúan aplicándose a través de los nuevos controles de geo.

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

• Control por solicitud: El parámetro inference_geo te permite especificar "us" o "global" en cada llamada a la API, dándote 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 de geo en todas las claves de un workspace.

Qué ocurrió con tu workspace

Tu workspace se migró automáticamente:

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 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 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.

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 todos los geos.
• Inference geo: Solo "us" y "global" están disponibles.
• Workspace geo: Solo "us" está disponible actualmente. El Workspace geo no se puede cambiar después de la creación del workspace.

Próximos pasos