Claude Platform Docs
MensajesGoogle Cloud

Claude Models on Google Cloud (Google managed)

Configura Claude Models on Google Cloud (Google managed), que Google opera como parte de Google Cloud’s Agent Platform. Luego, llama a Claude con el Anthropic SDK o cURL.

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 Modelos Anthropic Claude en 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 Modelos de socios de Agent Platform de Google Cloud.
  4. Credenciales de Google Cloud para esa identidad. Para autenticar el SDK con Google Cloud, es posible que necesites ejecutar gcloud auth application-default login. Una solicitud de cURL a Claude Models on Google Cloud (Google managed) puede obtener su token de gcloud auth print-access-token. Ese comando usa el inicio de sesión propio de la gcloud CLI, no las Application Default Credentials, así que ejecuta gcloud auth login o gcloud init antes de usarlo.

Instalar un SDK

El SDK de cliente admite 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 APIVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver.. 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 y no como encabezado. Establécelo en vertex-2023-10-16 o en la versión de API 2026-10-21.

El SDK gestiona ambas diferencias por ti. Mueve tu valor de model a la URL y establece anthropic_version en la versión de API que usa con la Claude API. Para conocer los IDs de modelo que debes pasar, consulta IDs de modelo de la API.

En los siguientes ejemplos, el cliente del SDK se autentica con Application Default Credentials. Para configurar las Application Default Credentials, consulta Antes de hacer llamadas a la API.

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

ModeloID de modelo de la API de Agent Platform
Claude Fable 5.2claude-fable-5-2
Claude Mythos 5.2 (disponibilidad limitada)claude-mythos-5-2
Claude Fable 5.1claude-fable-5-1
Claude Mythos 5.1 (disponibilidad limitada)claude-mythos-5-1
Claude Fable 5claude-fable-5
Claude Mythos 5 (disponibilidad limitada)claude-mythos-5
Claude Opus 5.5claude-opus-5-5
Claude Opus 5claude-opus-5
Claude Opus 4.8claude-opus-4-8
Claude Opus 4.7claude-opus-4-7
Claude Opus 4.6claude-opus-4-6
Claude Opus 4.5claude-opus-4-5@20251101
Claude Opus 4.1 (obsoleto)claude-opus-4-1@20250805
Claude Opus 4 (obsoleto)claude-opus-4@20250514
Claude Sonnet 5.5claude-sonnet-5-5
Claude Sonnet 5claude-sonnet-5
Claude Sonnet 4.6claude-sonnet-4-6
Claude Sonnet 4.5 (obsoleto)claude-sonnet-4-5@20250929
Claude Sonnet 4 (obsoleto)claude-sonnet-4@20250514
Claude Haiku 5.5claude-haiku-5-5
Claude Haiku 4.5claude-haiku-4-5@20251001

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 Modelos Anthropic Claude en 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 Modelos Anthropic Claude en Agent Platform de Google Cloud. Para saber qué significan Obsoleto y Retirado, consulta Obsolescencia de modelos.

Claude Code

Deja que Claude Code migre tu código a un modelo más reciente

/claude-api migrate este proyecto al modelo Claude Opus más reciente

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.

Tipo de endpointValor de regiónHost
Global (recomendado)"global"aiplatform.googleapis.com
Multirregional"us" o "eu"aiplatform.us.rep.googleapis.com
aiplatform.eu.rep.googleapis.com
RegionalUna región, como "us-east5"{region}-aiplatform.googleapis.com

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 por ciento más que los endpoints globales. Los tres tipos de endpoint aceptan tráfico de pago por uso, y el “provisioned throughput” (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:

La descripción general de funciones enumera todas las funciones. La página de cada función indica si Claude Models on Google Cloud (Google managed) la 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 API de uso y costos
  • 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.2
  • Claude Mythos 5.2
  • Claude Fable 5.1
  • Claude Mythos 5.1
  • Claude Fable 5
  • Claude Mythos 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 Cuotas para los modelos Anthropic Claude 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 Precios de IA generativa 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. 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. 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. 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 de cURL necesita una URL nueva, encabezados nuevos y un cuerpo nuevo. El siguiente código crea el cliente para Claude Models on Google Cloud (Anthropic managed) que usas actualmente:

    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.

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

Explora las funciones de Claude.

Comprueba qué modelos de Claude ofrece cada región y sus fechas de retiro.

Lee la documentación de Google Cloud’s Agent Platform.

Lee la publicación del blog de Google Cloud sobre el endpoint global para modelos de Claude.

¿Te resultó útil esta página?