Tailscaleロゴ

Vertex AI Expressプロバイダーをセットアップする

APIキー認証でVertex AI Expressプロバイダーを設定する

最終検証日：
翻訳: 竹洞 陽一郎

Aperture by Tailscaleは、現在ベータ版です。

ApertureにVertex AI Expressプロバイダーを設定すると、チームはtailnet経由でGoogle Geminiモデルにアクセスできます。
Vertex AI Expressは、サービスアカウントの代わりにAPIキー認証を使うため、Anthropicのサポートが不要でGeminiモデルだけが必要な場合に、設定を簡素化できます。

Vertex AI経由でAnthropic Claudeのモデルも必要な場合は、代わりにサービスアカウントを使うプロバイダーを使用してください。
Anthropicモデルが必要とするVertex AIの raw predict エンドポイントは、APIキー認証に対応していません。

Apertureを使うように設定したLLMクライアントであれば、このプロバイダーが提供するモデルにアクセスできます。
Apertureはモデル名に基づいてリクエストをルーティングするため、Vertex AIのためにクライアントを個別に設定する必要はありません。

前提条件

始める前に、次のものが必要です。

ステップ1: APIキーを作成する

Google Cloudコンソール、または gcloud CLIを使って、プロジェクトのGoogle Cloud APIキーを作成します。

Google Cloudコンソール

コンソールからAPIキーを作成するには、次の手順に従います。

  1. プロジェクトのAPI認証情報ページを開きます。
  2. 「認証情報を作成」、続いて「APIキー」を選択します。
  3. 生成されたキーをコピーします。

gcloud CLI

APIキーを作成するには、次のコマンドを実行します。 

gcloud services api-keys create --display-name="Aperture Vertex AI Express"

コマンドはキー文字列を出力します。次のステップのためにコピーしておきます。

（任意）APIキーをVertex AI APIに制限します。
制限のないキーでも動作しますが、必要以上に広いスコープを持つことになります。

ステップ2: プロバイダーを設定する

Apertureダッシュボードを使って、Apertureの構成にVertexプロバイダーを追加します。
認可タイプを x-goog-api-key に設定し、APIキーを直接指定します（keyfile:: の接頭辞は付けません）。

次の例は、Vertex Expressプロバイダーの構成を示しています。 

{
  "providers": {
    "vertex-express": {
      "baseurl": "https://aiplatform.googleapis.com",
      "authorization": "x-goog-api-key",
      "apikey": "<your-api-key>",
      "models": [
        "gemini-2.5-flash",
        "gemini-2.5-pro",
        "gemini-2.5-flash-lite"
      ],
      "compatibility": {
        "google_generate_content": true
      }
    }
  }
}

<your-api-key> は、前のステップで取得したAPIキーに置き換えてください。

compatibility セクションでは google_generate_content を有効にします。
これは、Geminiのような Google が公開するモデルが使う、Vertex AIの generateContent エンドポイント経由でリクエストをルーティングします。

google_raw_predict は有効にしないでください。
サードパーティ製モデル（Anthropic Claudeなど）は raw predict エンドポイントを使用しますが、これにはサービスアカウント認証が必要です。
APIキー認証は、このエンドポイントに対応していません。

プロバイダーを設定したら、Geminiモデルを必要とするユーザーまたはグループにモデルへのアクセスを許可してください。

プロバイダーを検証する

プロバイダーを設定したら、正しく動作することを確認します。

  1. Apertureダッシュボードを開き、Vertex Expressプロバイダーが期待どおりのモデルとともに表示されることを確認します。
  2. Gemini CLIのインスタンスや、Vertex AIエンドポイントを指す別のツールなど、接続済みのツールからテストリクエストを送信します。
  3. Apertureダッシュボードのセッション一覧で、そのリクエストに対応する新しいエントリを確認します。セッションには、モデル名、トークン数、タイムスタンプが表示されます。

リクエストが失敗する場合は、APIキーが正しいこと、およびGoogle CloudプロジェクトでVertex AI APIが有効になっていることを確認してください。
さらに助けが必要な場合は、Apertureのトラブルシューティングガイドを参照してください。

サービスアカウントを使うプロバイダーと比べた制限

Vertex AI Expressモードは設定が少なくて済みますが、サービスアカウントを使うプロバイダーに比べて機能は限られます。

APIキーをローテーションする

APIキーをローテーションするには、新しいキーを作成し、Apertureのプロバイダー設定を更新してから、古いキーを削除します。

  1. ステップ1の手順で新しいAPIキーを作成します。
  2. Apertureのプロバイダー設定の apikey フィールドを、新しいキーで更新します。
  3. API認証情報ページ、または gcloud CLIで、古いAPIキーを削除します。 
    gcloud services api-keys delete <old-key-id>

削除したキーを使用するリクエストは、削除後すぐに失敗します。