API de Vertex AI

La API de Vertex para acceder a Claude es casi idéntica a la API de Messages y admite todas las mismas opciones, con dos diferencias clave:

• En Vertex, model no se pasa en el cuerpo de la solicitud. En su lugar, se especifica en la URL del punto de conexión de Google Cloud.
• En Vertex, 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.

Vertex también es compatible con los SDK de cliente oficiales de Anthropic. Esta guía te llevará a través del proceso de realizar una solicitud a Claude en Vertex AI, ya sea en Python o TypeScript.

Ten en cuenta que esta guía asume que ya tienes un proyecto de GCP que puede utilizar Vertex AI. Consulta usando los modelos Claude 3 de Anthropic para obtener más información sobre la configuración requerida, así como una guía completa.

​

Instalar un SDK para acceder a Vertex AI

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

pip install -U google-cloud-aiplatform "anthropic[vertex]"

​

Accediendo a Vertex AI

​

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 Vertex AI Model Garden o visita Usar Claude 3 para obtener la información más reciente.

​

Nombres de modelos en la API

​

Realizando solicitudes

Antes de ejecutar solicitudes, es posible que debas ejecutar gcloud auth application-default login para autenticarte con GCP.

Los siguientes ejemplos muestran cómo generar texto desde Claude en Vertex AI:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
# Donde se está ejecutando el modelo
region = "us-east5"

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

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

Consulta nuestros SDK de cliente y la documentación oficial de Vertex AI para más detalles.

​

Registro de actividad

Vertex proporciona un servicio de registro de solicitudes y respuestas que permite a los clientes registrar los prompts y las respuestas asociadas con tu uso.

Anthropic recomienda que registres tu actividad en un ciclo continuo de al menos 30 días para comprender tu actividad e investigar cualquier posible uso indebido.