Vertex AI API

用于访问Claude的Vertex API与Messages API几乎完全相同，支持所有相同的选项，但有两个关键区别：

• 在Vertex中，model不在请求体中传递。相反，它在Google Cloud端点URL中指定。
• 在Vertex中，anthropic_version在请求体中传递（而不是作为标头），并且必须设置为值vertex-2023-10-16。

Vertex也受到Anthropic官方客户端SDK的支持。本指南将引导您完成在Python或TypeScript中向Vertex AI上的Claude发出请求的过程。

请注意，本指南假设您已经拥有能够使用Vertex AI的GCP项目。有关所需设置的更多信息以及完整演练，请参阅使用Anthropic的Claude 3模型。

​

安装用于访问Vertex AI的SDK

首先，为您选择的语言安装Anthropic的客户端SDK。

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

​

访问Vertex AI

​

模型可用性

请注意，Anthropic模型可用性因地区而异。在Vertex AI模型花园中搜索”Claude”或转到使用Claude 3获取最新信息。

​

API模型名称

​

发出请求

在运行请求之前，您可能需要运行gcloud auth application-default login来通过GCP进行身份验证。

以下示例显示了如何在Vertex AI上从Claude生成文本：

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
# 模型运行的位置
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)

有关更多详细信息，请参阅我们的客户端SDK和官方Vertex AI文档。

​

活动日志记录

Vertex提供请求-响应日志记录服务，允许客户记录与您的使用相关的提示和完成。

Anthropic建议您至少在30天滚动基础上记录您的活动，以便了解您的活动并调查任何潜在的滥用。

​

功能支持

您可以在这里找到Vertex当前支持的所有功能。