Vertex AI上のClaude

Claudeにアクセスするための Vertex APIは、Messages APIとほぼ同じであり、同じすべてのオプションをサポートしていますが、2つの主な違いがあります：

• 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 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)

詳細については、クライアント SDKと公式のVertex AI ドキュメントを参照してください。

アクティビティログ

Vertexは、リクエスト-レスポンスログサービスを提供しており、顧客はプロンプトと使用に関連する完了をログに記録できます。

Anthropicは、アクティビティを理解し、潜在的な悪用を調査するために、少なくとも30日間のローリングベースでアクティビティをログに記録することをお勧めします。

機能サポート

Vertexで現在サポートされているすべての機能は、ここで確認できます。

グローバルエンドポイント対地域エンドポイント

Claude Sonnet 4.5およびすべての将来のモデルから始まり、Google Vertex AIは2つのエンドポイントタイプを提供します：

• グローバルエンドポイント：最大可用性のための動的ルーティング
• 地域エンドポイント：特定の地理的領域を通じた保証されたデータルーティング

地域エンドポイントには、グローバルエンドポイントよりも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価格詳細： 価格ドキュメント