Google Cloud API キーを取得する

Vertex AI で Gemini を使用するには、Google Cloud API キーまたはアプリケーションのデフォルト認証情報を使用して認証します。テストには API キーを使用し、本番環境にはアプリケーションのデフォルト認証情報を使用することをおすすめします。

このページでは、 Google Cloud の新規ユーザーか既存ユーザーかに応じて Google Cloud API キーを取得する方法について説明します。

ユーザータイプを選択します。

Google Cloud を初めて使用する、またはエクスプレス モードを使用する 請求先アカウントを持つ既存の Google Cloud ユーザーである

---

Google Cloud API キーを作成する

請求が有効になっている標準の Google Cloud ユーザーである場合は、次の手順で標準の Google Cloud API キーを取得してください。API キーの代わりに、アプリケーションのデフォルト認証情報を使用することもできます。

始める前に

プロジェクトを選択して課金を有効にし、Vertex AI API を有効にする

Sign in to your Google Account.

If you don't already have one, sign up for a new account.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

サービス アカウントの API キーの作成を有効にする

重要: この操作を行うには、組織で組織ポリシー管理者のロールが有効になっているユーザー アカウントが必要です。このロールがない場合や、この構成を行えない場合は、代わりにアプリケーションのデフォルトの認証情報を使用します。

1. [IAM と管理] > [組織のポリシー] を開きます。
2. ポリシーのリストで、iam.managed.disableServiceAccountApiKeyCreation というポリシーをフィルタします。
3. [操作] > [ポリシーを編集] をクリックします。
4. [ポリシーのソース] で、[親のポリシーをオーバーライドする] を選択し、[ルールを追加] をクリックします。
5. [適用] で [オフ] を選択します。
6. [完了] をクリックします。
7. [ポリシーを設定] をクリックします。表示されたダイアログで、もう一度 [ポリシーを設定] をクリックします。

サービス アカウントを新規作成

1. [IAM と管理] > [サービス アカウント] を開きます。
2. [サービス アカウントを作成] をクリックします。
3. サービス アカウントを次のように構成します。
   • サービス アカウント名: vertex-ai-runner
   • サービス アカウント ID: vertexairunner
4. [作成して続行] をクリックします。
5. [権限] で、[ロールを選択] をクリックし、メニューから [Vertex AI Platform Express ユーザー] を選択します。
6. [続行] をクリックします。
7. [完了] をクリックします。

API キーを作成する

1. [API とサービス] > [認証情報] を開きます。
2. [認証情報を作成] > [API キー] をクリックします。
3. API キーを次のように構成します。
   • 名前: vertexaiapikey
   • サービス アカウントを介して API 呼び出しを認証する: 選択します。
4. [サービス アカウントを選択] をクリックします。
5. 前の手順で作成したサービス アカウントを選択し、[選択] をクリックします。
6. [作成] をクリックします。

最初のリクエストを送信する

API キーを取得したら、API クイックスタートで API キーを使用して最初のリクエストを行う方法を確認してください。

省略可: API キーをローカルで設定する

初期テストでは API キーをハードコードできますが、これは安全ではなく、一時的なものにすぎません。このセクションの残りの部分では、さまざまなオペレーティング システムで API キーをローカルで環境変数として設定する方法について説明します。

クリックして手順を開く

Linux / macOS

1. 次のコマンドを実行して、使用しているコマンドライン シェルを確認します。

   echo $SHELL

   出力は次のようになります。

   /bin/bash

2. 次のいずれかの方法で、API キーのシェル エクスポート変数を追加します。

   • 前の手順の出力が /bin/bash の場合:

     1. .bashrc を開きます。

        touch ~/.bashrc
                open ~/.bashrc

     2. .bashrc に次の行を追加します。

        export GEMINI_API_KEY=YOUR_API_KEY

     3. ファイルを保存し、次のコマンドを実行して変更を適用します。

        source ~/.bashrc

   • 前の手順の出力が /bin/zsh の場合:

     1. .zshrc を開きます。

        touch ~/.zshrc
                open ~/.zshrc

     2. .zshrc に次の行を追加します。

        export GEMINI_API_KEY= YOUR_API_KEY

     3. ファイルを保存し、次のコマンドを実行して変更を適用します。

        source ~/.zshrc

Windows

1. システム設定で「環境変数」を検索します。
2. [ユーザー変数]（現在のユーザーの場合）または [システム変数]（すべてのユーザーの場合 - 注意して使用）のいずれかを編集します。
3. 変数を作成して export GEMINI_API_KEY=YOUR_API_KEY を追加する
4. 変更を適用する

---

警告: API キーは安全に保管してください。API キーを使用する際は、次の点にご留意ください。

• Google Cloud では、アプリケーションを認証する本番環境で安全な方法としてアプリケーションのデフォルト認証情報を使用することをおすすめします。
• Vertex AI は、認可に API キーを使用します。他のユーザーが API キーにアクセスすると、そのユーザーはプロジェクトの割り当てを使用して呼び出しを行うことができます。これにより、チューニング済みモデルやファイルにアクセスできるだけでなく、割り当てが失われたり、課金対象プロジェクトに追加料金が発生する可能性があります。
• API キー制限を追加すると、各 API キーで使用できるサーフェス領域を制限できます。
• API キーのセキュリティは、お客様の責任で確保してください。
  • API キーをソース コントロールにチェックインしないでください。
  • クライアントサイド アプリケーション（Android、Swift、ウェブ、Dart/Flutter）では、API キーが公開されるリスクがあります。Google AI クライアント SDK を使用してモバイルアプリやウェブアプリから API を直接呼び出すことはおすすめしません。

一般的なベスト プラクティスについては、こちらのサポート記事もご覧ください。