Vertex AI 上的 Claude

用于访问 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]"

npm install @anthropic-ai/vertex-sdk

访问 Vertex AI

模型可用性

请注意，Anthropic 模型的可用性因地区而异。在 Vertex AI 模型库 中搜索"Claude"或访问 使用 Claude 3 以获取最新信息。

API 模型 ID

发出请求

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

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

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

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

活动日志记录

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

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

功能支持

您可以在 此处 找到 Vertex 上当前支持的所有功能。

全局端点与区域端点

从 Claude Sonnet 4.5 和所有未来模型 开始，Google Vertex AI 提供两种端点类型：

• 全局端点：动态路由以获得最大可用性
• 区域端点：通过特定地理区域保证数据路由

区域端点的价格比全局端点高 10%。

何时使用每个选项

全局端点（推荐）：

• 提供最大可用性和正常运行时间
• 动态将请求路由到具有可用容量的区域
• 无价格溢价
• 最适合数据驻留灵活的应用程序
• 仅支持按需付费流量（预配置吞吐量需要区域端点）

区域端点：

• 通过特定地理区域路由流量
• 数据驻留和合规性要求所需
• 支持按需付费和预配置吞吐量
• 10% 的价格溢价反映了专用区域容量的基础设施成本

实现

使用全局端点（推荐）：

初始化客户端时将 region 参数设置为 "global"：

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

使用区域端点：

指定特定区域，如 "us-east1" 或 "europe-west1"：

from anthropic import AnthropicVertex

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

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

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

其他资源

• Google Vertex AI 定价： cloud.google.com/vertex-ai/generative-ai/pricing
• Claude 模型文档： Vertex AI 上的 Claude
• Google 博客文章： Claude 模型的全局端点
• Anthropic 定价详情： 定价文档