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:
- 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.
- La gcloud CLI instalada, para el desarrollo local.
- 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. - 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 degcloud auth print-access-token. Ese comando usa el inicio de sesión propio de la gcloud CLI, no las Application Default Credentials, así que ejecutagcloud auth loginogcloud initantes 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
modeldel cuerpo. - Versión: En una solicitud cURL, pasa
anthropic_versionen el cuerpo y no como encabezado. Establécelo envertex-2023-10-16o en la versión de API2026-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
| Modelo | ID de modelo de la API de Agent Platform |
|---|---|
| Claude Fable 5.2 | claude-fable-5-2 |
| Claude Mythos 5.2 (disponibilidad limitada(se abre en una nueva pestaña)) | claude-mythos-5-2 |
| Claude Fable 5.1 | claude-fable-5-1 |
| Claude Mythos 5.1 (disponibilidad limitada(se abre en una nueva pestaña)) | claude-mythos-5-1 |
| Claude Fable 5 | claude-fable-5 |
| Claude Mythos 5 (disponibilidad limitada(se abre en una nueva pestaña)) | claude-mythos-5 |
| Claude Opus 5.5 | claude-opus-5-5 |
| Claude Opus 5 | claude-opus-5 |
| Claude Opus 4.8 | claude-opus-4-8 |
| Claude Opus 4.7 | claude-opus-4-7 |
| Claude Opus 4.6 | claude-opus-4-6 |
| Claude Opus 4.5 | claude-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.5 | claude-sonnet-5-5 |
| Claude Sonnet 5 | claude-sonnet-5 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Sonnet 4.5 (obsoleto) | claude-sonnet-4-5@20250929 |
| Claude Sonnet 4 (obsoleto) | claude-sonnet-4@20250514 |
| Claude Haiku 5.5 | claude-haiku-5-5 |
| Claude Haiku 4.5 | claude-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 recienteEndpoints 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 endpoint | Valor de región | Host |
|---|---|---|
| Global (recomendado) | "global" | aiplatform.googleapis.com |
| Multirregional | "us" o "eu" | aiplatform.us.rep.googleapis.comaiplatform.eu.rep.googleapis.com |
| Regional | Una 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:
- 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.
- “Prompt caching” (almacenamiento en caché de prompts)
- Pensamiento
- “Tool use” (uso de herramientas), incluidas estas herramientas:
- Citas
- Salidas estructuradas
- “Fast mode” (modo rápido) en modelos compatibles
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:
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.
Instala el paquete del SDK
Instala el paquete que proporciona el cliente para Claude Models on Google Cloud (Google managed). Consulta Instalar un SDK.
Reemplaza la importación y el cliente
Cambia el código que importa y crea tu cliente. Usa
AnthropicVertexen lugar deAnthropicGoogleCloud. 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:Pythonfrom 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.
Pythonfrom 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_IDcon 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.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-20251001se convierte enclaude-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.
- 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
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?