Claude on Google Cloud

在 Google Cloud's Agent Platform 上存取 Claude 的 API 與 Messages API 幾乎完全相同，但在請求格式上有兩個主要差異：

• 在 Agent Platform 上，model 不是在請求主體中傳遞。而是在 Google Cloud 端點 URL 中指定。
• 在 Agent Platform 上，anthropic_version 是在請求主體中傳遞（而不是作為標頭），且必須設定為 vertex-2023-10-16 這個值。

Agent Platform 也受到 Anthropic 官方用戶端 SDK 的支援。本指南將引導您使用 Anthropic 的其中一個用戶端 SDK 向 Agent Platform 上的 Claude 發出請求。

請注意，本指南假設您已經擁有一個能夠使用 Agent Platform 的 Google Cloud 專案。請參閱 Agent Platform 上的 Anthropic Claude 模型以了解所需設定的更多資訊和完整的操作說明。



安裝用於存取 Agent Platform 的 SDK

首先，為您選擇的語言安裝 Anthropic 的用戶端 SDK。



存取 Agent Platform



模型可用性

請注意，Anthropic 模型的可用性因地區而異。在 Model Garden 中搜尋「Claude」，或前往 Anthropic Claude 模型以取得最新資訊。



API 模型 ID

生命週期術語（已棄用、已停用）的定義請參閱模型棄用。合作夥伴營運平台上的生命週期日期由合作夥伴設定，可能與 Claude API 的時程不同。如需 Agent Platform 上任何模型目前的停用日期，請參閱 Google Cloud 關於 Agent Platform 上 Claude 模型的文件。



發出請求

在執行請求之前，您可能需要執行 gcloud auth application-default login 以向 Google Cloud 進行身份驗證。

以下範例展示如何從 Agent Platform 上的 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-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

請參閱用戶端 SDK 和官方 Agent Platform 文件以了解更多詳細資訊。

Claude 也可透過 Amazon Bedrock、Claude Platform on AWS 和 Microsoft Foundry 使用。



資料保留

此服務的資料處理由 Google Cloud 管理。詳細資訊請參閱 Agent Platform 與零資料保留。



活動記錄

Agent Platform 提供請求-回應記錄服務，讓客戶可以記錄與您的使用相關的提示和完成內容。

Anthropic 建議您至少以 30 天滾動的方式記錄您的活動，以便了解您的活動並調查任何潛在的濫用行為。



功能支援

如需包含 Google Cloud 可用性的完整功能清單，請參閱功能概覽。



支援的功能重點

• Messages API
• 提示快取
• 擴展思考
• 工具使用，包括 Bash 工具、電腦使用工具、記憶工具和文字編輯器工具
• 網頁搜尋工具
• 引用
• 結構化輸出



不支援的功能

• 輸入來源（圖片和文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁擷取、advisor）
• 代理基礎設施（Agent Skills、MCP 連接器、程式化工具呼叫）
• API 端點（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• 伺服器端後備（fallbacks 參數；請改用用戶端後備模式）



上下文視窗

Claude Fable 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5 和 Claude Sonnet 4.6 在 Agent Platform 上擁有 100 萬 token 的上下文視窗。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已棄用），擁有 20 萬 token 的上下文視窗。

Agent Platform 將請求負載限制為 30 MB。在傳送大型文件或大量圖片時，您可能會在達到 token 限制之前先達到此限制。



全球、多區域和區域端點

Agent Platform 提供三種端點類型：

• 全球端點： 動態路由以獲得最大可用性
• 多區域端點： 在地理區域內（例如美國或歐盟）進行動態路由，以實現具有高可用性的資料駐留
• 區域端點： 保證資料透過特定地理區域進行路由

區域和多區域端點的價格比全球端點高出 10%。



何時使用各選項

全球端點（建議）：

• 提供最大的可用性和正常運行時間
• 動態將請求路由到有可用容量的區域
• 無額外費用
• 最適合資料駐留要求較彈性的應用程式
• 僅支援隨用隨付流量（佈建輸送量需要區域端點）

多區域端點：

• 在地理區域內（目前為 us 和 eu）跨區域動態路由請求
• 當您需要在廣泛的地理範圍內實現資料駐留，但希望獲得比單一區域更高的可用性時很有用
• 價格比全球端點高出 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-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

使用多區域端點：

將 region 參數設定為多區域識別碼：美國為 "us"，歐盟為 "eu"。SDK 會將請求路由到對應的多區域端點（https://aiplatform.us.rep.googleapis.com 或 https://aiplatform.eu.rep.googleapis.com），該端點會在該地理範圍內的各區域之間動態平衡流量。

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



其他資源

• Agent Platform 定價： cloud.google.com 上的生成式 AI 定價
• Claude 模型文件： Agent Platform 上的 Claude
• Google 部落格文章： Claude 模型的全球端點
• Anthropic 定價詳細資訊： 雲端平台定價