Claude Models on Google Cloud (Google managed)

Claude Models on Google Cloud compara las dos ofertas de Google Cloud. También muestra cómo saber cuál usas.

Antes de hacer llamadas a la API

Para usar Claude Models on Google Cloud (Google managed), necesitas:

1. Un proyecto de Google Cloud que pueda usar Agent Platform. Para conocer los pasos de configuración, consulta la página Anthropic Claude models on Agent Platform de Google Cloud.
2. La gcloud CLI instalada, para el desarrollo local.
3. Para la identidad que hace las llamadas, un rol de IAM que incluya el permiso aiplatform.endpoints.predict, como Agent Platform User (roles/aiplatform.user). Para obtener más detalles, consulta la página Agent Platform partner models de Google Cloud.
4. Credenciales de Google Cloud para esa identidad. Para los ejemplos del SDK, es posible que necesites ejecutar gcloud auth application-default login para autenticarte con Google Cloud. Los ejemplos de cURL para Claude Models on Google Cloud (Google managed) obtienen su token con gcloud auth print-access-token. Ese comando usa el inicio de sesión propio de la gcloud CLI, no las Application Default Credentials. Para esos ejemplos, ejecuta primero gcloud auth login o gcloud init.

Instalar un SDK

Los SDK de cliente de Anthropic admiten Claude Models on Google Cloud (Google managed) mediante AnthropicVertex. Instala el paquete que lo proporciona:

pip install -U "anthropic[vertex]"

La CLI ant no admite Claude Models on Google Cloud (Google managed).

Hacer solicitudes

Las solicitudes a Claude Models on Google Cloud (Google managed) van a una URL de endpoint de Agent Platform que termina en :rawPredict. Las solicitudes de streaming usan :streamRawPredict en su lugar.

Una solicitud es casi idéntica a una solicitud de la Messages API. Se diferencia en dos aspectos principales:

• Modelo: La URL del endpoint nombra el modelo. En una solicitud cURL, omite model del cuerpo.
• Versión: En una solicitud cURL, pasa anthropic_version en el cuerpo, no como encabezado. Establécelo en vertex-2023-10-16 o en la versión de API 2026-10-21.

Los siguientes ejemplos usan el endpoint global. Para los otros tipos de endpoint, consulta Endpoints globales, multirregionales y regionales.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

IDs de modelo de la API

Claude Models on Google Cloud (Google managed) ofrece diferentes modelos de Claude en diferentes regiones. Para comprobar qué modelos ofrece una región, busca "Claude" en Model Garden o consulta la página Anthropic Claude models on Agent Platform de Google Cloud.

Google establece las fechas del ciclo de vida de los modelos que sirve Claude Models on Google Cloud (Google managed). Estas fechas pueden diferir del calendario de la Claude API. Para conocer la fecha de retiro actual de un modelo, consulta la página Anthropic Claude models on Agent Platform de Google Cloud. Para saber qué significan Obsoleto y Retirado, consulta Obsolescencia de modelos.

Endpoints globales, multirregionales y regionales

Claude Models on Google Cloud (Google managed) ofrece tres tipos de endpoint. Eliges uno con el valor de región que pasas al crear el cliente. En una solicitud cURL, el tipo de endpoint establece el host y el segmento locations de la URL.

Los tipos de endpoint difieren en adónde envían las solicitudes:

• Global: Las solicitudes van a cualquier región con capacidad disponible. Úsalo cuando quieras la máxima disponibilidad y la residencia de datos sea flexible.
• Multirregional: Las solicitudes van a cualquier región de los Estados Unidos ("us") o de la Unión Europea ("eu"). Úsalo cuando necesites residencia de datos dentro de una geografía amplia y mayor disponibilidad que la de una sola región.
• Regional: Las solicitudes van solo a la región que indiques, como "us-east5" o "europe-west1". Úsalo cuando necesites residencia de datos en una sola región o debas cumplir requisitos de cumplimiento normativo estrictos.

Los endpoints multirregionales y regionales cuestan un 10% más que los endpoints globales. Los tres tipos de endpoint aceptan tráfico de pago por uso, y el rendimiento aprovisionado requiere un endpoint regional.

Los endpoints regionales sirven solo Claude Sonnet 4.6 y modelos anteriores. Para modelos más recientes, usa un endpoint global o multirregional.

Los siguientes ejemplos usan el endpoint multirregional us. Las líneas resaltadas establecen la región. Para ver una solicitud completa en el endpoint global, consulta Hacer solicitudes.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

Compatibilidad de funciones

Las funciones compatibles con Claude Models on Google Cloud (Google managed) incluyen las siguientes:

• Messages API
• "Prompt caching" (almacenamiento en caché de prompts)
• Pensamiento
• "Tool use" (uso de herramientas), incluidas estas herramientas:
  • Herramienta Bash
  • Herramienta de uso del navegador
  • Herramienta de uso de computadora
  • Herramienta de memoria
  • Herramienta de editor de texto
  • Herramienta de búsqueda web
• Citas
• Salidas estructuradas

La descripción general de funciones enumera todas las funciones e indica si Claude Models on Google Cloud (Google managed) las admite.

Funciones no compatibles

Claude Models on Google Cloud (Google managed) no admite lo siguiente:

• Fuentes de entrada: Fuentes URL para imágenes y documentos, y la Files API
• Herramientas del lado del servidor: Ejecución de código, obtención web y asesor
• Infraestructura de agentes: Agent Skills, conector MCP y llamada programática de herramientas
• Endpoints de la API: Message Batches API, Models API, Admin API, Compliance API y Usage and Cost API
• Claude Managed Agents
• Respaldo del lado del servidor: El parámetro fallbacks

En lugar del respaldo del lado del servidor, usa el patrón de respaldo del lado del cliente.

Ventana de contexto

Claude Models on Google Cloud (Google managed) ofrece una "context window" (ventana de contexto) de 1M de tokens para estos modelos:

• Claude Fable 5.1
• Claude Fable 5
• Claude Opus 5.5
• Claude Opus 5
• Claude Opus 4.8
• Claude Opus 4.7
• Claude Opus 4.6
• Claude Sonnet 5.5
• Claude Sonnet 5
• Claude Sonnet 4.6
• Claude Haiku 5.5

Otros modelos de Claude tienen una ventana de contexto de 200k tokens. Entre ellos se incluyen Claude Sonnet 4.5 (obsoleto) y Claude Sonnet 4 (obsoleto).

Agent Platform limita las cargas útiles de las solicitudes a 30 MB. Cuando envías documentos grandes o muchas imágenes, es posible que alcances este límite antes que el límite de tokens.

Facturación, límites de velocidad y registro

Límites de velocidad

Google Cloud administra los "rate limits" (límites de velocidad) y las cuotas de Claude Models on Google Cloud (Google managed). Para obtener más detalles, incluido cómo solicitar un aumento de cuota, consulta la página Quotas for Anthropic Claude models de Google Cloud.

Facturación

Google Cloud te factura por Claude Models on Google Cloud (Google managed). Para conocer los precios, consulta la página Generative AI pricing de Google Cloud. Los precios también dependen del tipo de endpoint. Consulta Endpoints globales, multirregionales y regionales.

Retención de datos

Google Cloud rige el manejo de datos de Claude Models on Google Cloud (Google managed). Para obtener más detalles, consulta Agent Platform y retención cero de datos.

Monitoreo y registro

Para registrar prompts y respuestas de Claude Models on Google Cloud (Google managed), usa el servicio de registro de solicitudes y respuestas de Agent Platform.

Anthropic recomienda que conserves al menos los últimos 30 días de registros. Los registros te ayudan a comprender tu actividad e investigar posibles usos indebidos.

Migrar desde Claude Models on Google Cloud (Anthropic managed)

Para saber qué cambia al migrar, consulta En qué se diferencian las dos ofertas de Google Cloud. Para migrar a Claude Models on Google Cloud (Google managed), sigue estos pasos:

1. 1

   Configura el acceso

   Comprueba que tu proyecto y la identidad que hace las llamadas cumplan los requisitos de Antes de hacer llamadas a la API.

2. 2

   Instala el paquete del SDK

   Instala el paquete que proporciona el cliente para Claude Models on Google Cloud (Google managed). Consulta Instalar un SDK.

3. 3

   Reemplaza la importación y el cliente

   Cambia el código que importa y crea tu cliente. Usa AnthropicVertex en lugar de AnthropicGoogleCloud. Una solicitud cURL necesita una nueva URL, nuevos encabezados y un nuevo cuerpo. El siguiente código crea el cliente para Claude Models on Google Cloud (Anthropic managed) que usas actualmente:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   El siguiente código crea el cliente para Claude Models on Google Cloud (Google managed). Usa el endpoint global. Para los otros tipos de endpoint, consulta Endpoints globales, multirregionales y regionales.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   Este código pasa tu ID de proyecto y una región al crear el cliente. Reemplaza MY_PROJECT_ID con tu ID de proyecto. Las llamadas a la Messages API que haces con el cliente se mantienen igual. Las excepciones son los IDs de modelo y las funciones del siguiente paso.

4. 4

   Comprueba los IDs de modelo y las funciones

   • IDs de modelo: Si usas un modelo anterior a Claude 4.6, reemplaza el guion antes de la fecha de la instantánea en su ID por @. Por ejemplo, claude-haiku-4-5-20251001 se convierte en claude-haiku-4-5@20251001. Para conocer los modelos y sus IDs, consulta IDs de modelo de la API.
   • Funciones: Comprueba que las funciones que usa tu código no aparezcan en Funciones no compatibles.
5. 5

   Ejecuta una solicitud de prueba

   Ejecuta la solicitud de Hacer solicitudes para comprobar que tu configuración funciona. Luego ejecuta tu propio código. Antes de mover el tráfico de producción, lee sobre los límites de velocidad de Claude Models on Google Cloud (Google managed).

Próximos pasos