コンテンツへスキップ

移行ガイドGoogle Vertex AIから

Vertex AIだけの構成から、Vertexを複数のプロバイダーの1つにする構成へ

現在Gemini Enterprise Agent Platformの一部となったVertex AIは、お客様のGoogle Cloudプロジェクト内でGeminiとAnthropicのClaudeを提供し、Googleが請求します。INFROは、そのプロジェクトのサービスアカウントでこれを呼び出します。アプリは1つのエンドポイントを呼び出し、呼び出しのたびに予算を確認したうえで、Vertex上のClaudeとAnthropic上のClaude、あるいはVertex上のGeminiとGoogle AI上のGeminiの間でフェイルオーバーできます。

2026-04-22にGemini Enterprise Agent Platformに名称変更。ホストは同じaiplatform.googleapis.com

INFROのアカウントはセルフサービスで作成できます。 カタログ、ドキュメント、API仕様は公開済みで、ゲートウェイもデプロイ済みです。v1以降の機能には「今後提供」と表示しています。 プランとトライアル

現状

名称変更

Googleのリリースノートによると、2026-04-22にVertex AIはGemini Enterprise Agent Platformの一部となり、Vertex AI APIは現在Agent Platform APIになっています。ドキュメントに記載されているホストは引き続きaiplatform.googleapis.comです。

SDKの変更

Google Gen AI SDKは現在enterprise=Trueを受け付け、vertexai=Trueはレガシーのフラグとして残っています。2026-09-18に、以前のPython SDKはgoogle-cloud-agentplatformに移行しました。

INFROが呼び出すもの

お客様のプロジェクト内のlocations/globalのVertex AI。有効期間の短いトークンを、roles/aiplatform.userだけを必要とするサービスアカウントキーから署名します。各ClaudeモデルはModel Gardenのカードで有効化する必要があります。

動かしているものがすべてGoogle Cloudにあり、疑問にはすでにGoogleのツールが答えているなら、そのままにしてください。具体的には次のようなケースです。

  • 組織でサービスアカウントキーが禁止されている。INFROのVertex接続はサービスアカウントキーを使い、Workload Identity連携は使いません。
  • 明示的なコンテキストキャッシュ（caches.createとcached_content）、グラウンディング、またはチャット形式では引き継げないその他のGemini固有の機能を使っている。
  • コスト配分のために、labelsがCloud Billingに届くことに頼っている。INFROは配分を独自のmetadataに記録します。
  • データの所在のためにリージョンまたはマルチリージョンのエンドポイントが必要。INFROはグローバルのロケーションを呼び出します。データの所在の指定はロードマップにあります。

変更点を1行ずつ。ここにないものはそのままです。

 Google Vertex AIINFRO
ベースURLaiplatform.googleapis.com/v1/projects/{project}/locations/{location}/...https://api.infro.io/v1（OpenAIの形式）、Anthropic SDKではhttps://api.infro.io。
認証情報Application Default Credentialsから取得する有効期間1時間のアクセストークン。INFROのゲートウェイキー。INFROはサービスアカウントキーを暗号化して保持し、有効期間の短いトークンを自ら署名します。
モデルIDgemini-3.8-flash, google/gemini-3.8-flash, claude-sonnet-5-5.google/gemini-3.8-flash、anthropic/claude-sonnet-5.5。Anthropic SDKは/v1/messagesでclaude-sonnet-5-5をそのまま使えます。
フィールドlabels、またはパートナーモデルではX-Vertex-AI-Labels。metadata { user_id, session_id, tags }はINFROが記録し、Googleには送りません。

変更前 · Vertex AI

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  enterprise: true, // formerly vertexai: true
  project: "my-project",
  location: "global",
});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Hello",
  config: { labels: { team: "search" } },
});

変更後 · INFRO

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.infro.io/v1",
  apiKey: process.env.INFRO_API_KEY,
});

await client.chat.completions.create({
  model: "google/gemini-3.8-flash",
  messages: [{ role: "user", content: "Hello" }],
  // @ts-expect-error INFRO extension
  metadata: { tags: { team: "search" } },
});

GeminiはOpenAIの形式に移行

Gen AI SDKを使ったコードは、リクエスト形式がChat Completionsに変わります。明示的なコンテキストキャッシュなど、その形式で引き継げない機能を使う呼び出しは、直接のままにする理由になります。

ClaudeはAnthropicの形式のまま

Vertex接続では、/v1/messagesはボディを書かれたとおりに送ります。thinkingブロック、cache_control、ツールも含みます。ルートで、同じClaudeモデルについてVertexを1番目、Anthropicを2番目にできます。

1つのサービスアカウント

付与するのはroles/aiplatform.userだけにしてください。INFROはこれを使って呼び出しごとに有効期間1時間のトークンに署名し、プロジェクト内のそれ以外のものは何も読み取りません。

Google Vertex AIのオブジェクトとINFROのオブジェクトの対応。2026年10月19日に読んだGoogle Vertex AIの公開ドキュメントに基づき、ゲートウェイの実装と照合しています。 INFROにないものは1行あります。

Google Vertex AIそこでの役割INFROでは
プロジェクトと認証情報異なるお客様のGoogle Cloudプロジェクト。ADCまたはサービスアカウントのトークン。サービスアカウントキーを暗号化して保持するVertex接続。トークンは呼び出しごとに署名します。Workload Identity連携には非対応です。
Gemini `generateContent`異なるGen AI SDK経由のネイティブGemini API。チャット補完ではOpenAIの形式で提供されます。ネイティブ専用の機能は引き継がれません。
Claude `rawPredict`同じ形式Vertex上のAnthropicのMessages形式のボディ。/v1/messages。書かれたとおりにVertexへ送られます。
グローバルエンドポイントとリージョンエンドポイント異なるグローバル、リージョン、マルチリージョンから選択。グローバルのロケーションのみ。
ラベル異なるCloud Billingに転送されるコストラベル。INFROのリクエストログと利用状況でのmetadataによる配分。プロジェクト、キー、ユーザー、タグ別。
コンテキストキャッシュなしcached_contentで作成・参照する明示的なキャッシュ。同等のものはありません。Claudeのcache_controlは書かれたとおりにVertexへ届き、INFROは完全一致のレスポンスキャッシュを追加します。
クォータとProvisioned Throughput異なるDynamic Shared Quota、Standard PayGoのティア、Provisioned Throughput。Google側は変わりません。429はルートの障害ルールに従います。INFROはドル建ての予算を追加します。
フェイルオーバー異なるグローバルエンドポイントがリージョンを選びます。プロバイダーをまたぐ処理はお客様のコード側の役割です。Vertex、Anthropic、Google AIなどをまたぐルート。種類ごとの障害ルール付き。

Google Vertex AIの公開ドキュメントに対する当社の読み取りであり、トライアルやベンチマークではありません。誤りがあればお知らせください。該当する行を修正します。

INFROが行わないこと

  • Workload Identity連携やADCを使うこと。サービスアカウントキーが必要です。
  • リージョンまたはマルチリージョンのVertexエンドポイントを呼び出すこと。
  • 明示的なコンテキストキャッシュやグラウンディングなど、Gemini固有の機能を引き継ぐこと。
  • 請求ラベルを転送すること、またはGoogle Cloudの請求と突合すること。

引き継がれないもの

  • Cloud LoggingとMonitoringの履歴。Google Cloudに残ります。
  • コンテキストキャッシュ。お客様のプロジェクトに残ります。

質問

INFROはVertex AI上のClaudeをルーティングできますか？
はい。サービスアカウントキーでVertex AIを接続し、Model GardenでClaudeモデルを有効にして、/v1/messagesまたはチャット補完を呼び出してください。
利用料は誰が請求しますか？
お客様自身のプロジェクトでGoogle Cloudから。INFROはサブスクリプションで、モデル支出への上乗せは0%です。
INFROにはどの権限が必要ですか？
roles/aiplatform.userを持つサービスアカウント。INFROはこれをVertex AIの呼び出しにのみ使います。

当社と一緒に、またはご自身で移行

移行プログラムでは、通話でGoogle Vertex AIの設定をINFROの接続、ルート、予算に対応付け、最初のサービスを一緒に移行します。プロバイダーは引き続きお客様に直接請求し、INFROはサブスクリプションで、モデル利用料への上乗せは0%です。

14日間のトライアルを開始 移行セッションを予約クイックスタートを読む

出典

このページにあるGoogle Vertex AIについての記述は、すべて2026年10月19日に読んだこれらの資料に基づいています。トライアル、ベンチマーク、会話から推測したものはありません。