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 価格詳細： 価格ドキュメント