Vertex AI 上的 Claude

用於存取 Claude 的 Vertex API 幾乎與 Messages API 相同，並支援所有相同的選項，但有兩個主要差異：

• 在 Vertex 中，model 不在請求正文中傳遞。相反，它在 Google Cloud 端點 URL 中指定。
• 在 Vertex 中，anthropic_version 在請求正文中傳遞（而不是作為標頭），並且必須設定為值 vertex-2023-10-16。

Vertex 也受到 Anthropic 官方 client SDKs 的支援。本指南將引導您完成使用 Python 或 TypeScript 向 Vertex AI 上的 Claude 發出請求的過程。

請注意，本指南假設您已經擁有能夠使用 Vertex AI 的 GCP 專案。有關所需的設定以及完整的逐步說明，請參閱 使用 Anthropic 的 Claude 3 模型。

安裝用於存取 Vertex AI 的 SDK

首先，為您選擇的語言安裝 Anthropic 的 client SDK。

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

npm install @anthropic-ai/vertex-sdk

存取 Vertex AI

模型可用性

請注意，Anthropic 模型的可用性因地區而異。在 Vertex AI Model Garden 中搜尋「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)

如需更多詳細資訊，請參閱我們的 client SDKs 和官方 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"  # 指定特定區域

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 定價詳細資訊： 定價文件