Claude en Google Cloud

La API para acceder a Claude en Agent Platform de Google Cloud es casi idéntica a la Messages API, con dos diferencias clave en el formato de la solicitud:

• En Agent Platform, model no se pasa en el cuerpo de la solicitud. En su lugar, se especifica en la URL del endpoint de Google Cloud.
• En Agent Platform, anthropic_version se pasa en el cuerpo de la solicitud (en lugar de como un encabezado), y debe establecerse con el valor vertex-2023-10-16.

Agent Platform también es compatible con los SDKs de cliente oficiales de Anthropic. Esta guía te muestra cómo hacer una solicitud a Claude en Agent Platform usando uno de los SDKs de cliente de Anthropic.

Ten en cuenta que esta guía asume que ya tienes un proyecto de Google Cloud que puede usar Agent Platform. Consulta Modelos Claude de Anthropic en Agent Platform para obtener más información sobre la configuración requerida y un tutorial completo.



Instalar un SDK para acceder a Agent Platform

Primero, instala el SDK de cliente de Anthropic para el lenguaje de tu elección.

pip install -U "anthropic[vertex]"



Acceder a Agent Platform



Disponibilidad de modelos

Ten en cuenta que la disponibilidad de los modelos de Anthropic varía según la región. Busca "Claude" en el Model Garden o visita Modelos Claude de Anthropic para obtener la información más reciente.



IDs de modelo de la API

Los términos del ciclo de vida (Obsoleto, Retirado) se definen en Obsolescencia de modelos. Las fechas del ciclo de vida en plataformas operadas por socios las establece el socio y pueden diferir del calendario de la API de Claude. Para conocer la fecha de retiro actual de cualquier modelo en Agent Platform, consulta la documentación de Google Cloud para modelos Claude en Agent Platform.



Realizar solicitudes

Antes de ejecutar solicitudes, es posible que necesites ejecutar gcloud auth application-default login para autenticarte con Google Cloud.

Los siguientes ejemplos muestran cómo generar texto desde Claude en Agent Platform:

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulta los SDKs de cliente y la documentación oficial de Agent Platform para obtener más detalles.

Claude también está disponible a través de Amazon Bedrock, Claude Platform en AWS y Microsoft Foundry.



Retención de datos

El manejo de datos para esta oferta está regido por Google Cloud. Para más detalles, consulta Agent Platform y retención cero de datos.



Registro de actividad

Agent Platform proporciona un servicio de registro de solicitudes y respuestas que te permite registrar los prompts y las respuestas generadas asociadas con tu uso.

Anthropic recomienda que registres tu actividad con una retención continua de al menos 30 días para comprender tu actividad e investigar cualquier posible uso indebido.



Compatibilidad de funciones

Para ver la lista completa de funciones con disponibilidad en Google Cloud, consulta Descripción general de funciones.



Funciones compatibles destacadas

• Messages API
• Almacenamiento en caché de prompts
• Pensamiento
• Uso de herramientas, incluyendo la herramienta Bash, la herramienta de uso de computadora, la herramienta de memoria y la herramienta de editor de texto
• Herramienta de búsqueda web
• Citas
• Salidas estructuradas



Funciones no compatibles

• Fuentes de entrada (fuentes URL para imágenes y documentos, Files API)
• Herramientas del lado del servidor (ejecución de código, web fetch, advisor)
• Infraestructura de agentes (Agent Skills, conector MCP, llamadas programáticas a herramientas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback del lado del servidor (el parámetro fallbacks; usa el patrón de fallback del lado del cliente en su lugar)



Ventana de contexto

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 y Claude Sonnet 4.6 tienen una ventana de contexto de 1M de tokens en Agent Platform. Otros modelos de Claude, incluidos Sonnet 4.5 y Sonnet 4 (obsoleto), tienen una ventana de contexto de 200k tokens.

Agent Platform limita las cargas útiles de las solicitudes a 30 MB. Al enviar documentos grandes o muchas imágenes, podrías alcanzar este límite antes que el límite de tokens.



Endpoints globales, multirregionales y regionales

Agent Platform ofrece tres tipos de endpoints:

• Endpoints globales: Enrutamiento dinámico para máxima disponibilidad
• Endpoints multirregionales: Enrutamiento dinámico dentro de un área geográfica (por ejemplo, Estados Unidos o la Unión Europea) para residencia de datos con alta disponibilidad
• Endpoints regionales: Enrutamiento de datos garantizado a través de regiones geográficas específicas

Los endpoints regionales y multirregionales incluyen un recargo del 10% en el precio respecto a los endpoints globales.



Cuándo usar cada opción

Endpoints globales (recomendado):

• Proporcionan máxima disponibilidad y tiempo de actividad
• Enrutan dinámicamente las solicitudes a regiones con capacidad disponible
• Sin recargo en el precio
• Ideal para aplicaciones donde la residencia de datos es flexible
• Solo admite tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints multirregionales:

• Enrutan dinámicamente las solicitudes entre regiones dentro de un área geográfica (actualmente us y eu)
• Útil cuando necesitas residencia de datos dentro de una geografía amplia pero quieres mayor disponibilidad que una sola región
• Recargo del 10% en el precio respecto a los endpoints globales
• Solo admite tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints regionales:

• Enrutan el tráfico a través de regiones geográficas específicas
• Requeridos para residencia de datos en una sola región, mandatos estrictos de cumplimiento o rendimiento aprovisionado
• Admiten tanto pago por uso como rendimiento aprovisionado
• El recargo del 10% en el precio refleja los costos de infraestructura para capacidad regional dedicada



Implementación

Usar endpoints globales (recomendado):

Establece el parámetro region en "global" al inicializar el cliente:

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Usar endpoints multirregionales:

Establece el parámetro region en un identificador multirregional: "us" para Estados Unidos o "eu" para la Unión Europea. El SDK enruta las solicitudes al endpoint multirregional correspondiente (https://aiplatform.us.rep.googleapis.com o https://aiplatform.eu.rep.googleapis.com), que equilibra dinámicamente el tráfico entre las regiones dentro de esa geografía.

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)

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

Usar endpoints regionales:

Especifica una región concreta como "us-east5" o "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

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

message = client.messages.create(
    # Los endpoints regionales específicos admiten Claude Sonnet 4.6 y anteriores; los modelos más recientes usan los endpoints globales o multirregión
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)



Recursos adicionales

• Precios de Agent Platform: Precios de IA generativa en cloud.google.com
• Documentación de modelos Claude: Claude en Agent Platform
• Publicación del blog de Google: Endpoint global para modelos Claude
• Detalles de precios de Anthropic: Precios de plataformas en la nube