取得 Google Cloud API 金鑰

如要在 Vertex AI 上使用 Gemini，您必須使用 Google Cloud API 金鑰或應用程式預設憑證進行驗證。建議您在測試時使用 API 金鑰，並在正式環境中使用應用程式的預設憑證。本頁面會說明如何取得 Google Cloud API 金鑰，具體做法取決於您是否已擁有 Google Cloud 帳戶。

選取您是否有 Google Cloud 帳戶：

建立 Google Cloud API 金鑰

如果您已擁有 Google Cloud 帳戶，請按照以下操作說明取得標準 Google Cloud API 金鑰。您也可以改用應用程式預設憑證，而非使用 API 金鑰。

事前準備

選取專案、啟用帳單功能、啟用 Vertex AI API

  1. Sign in to your Google Account.

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

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

啟用服務帳戶 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. 依序按一下 [Create credentials] (建立憑證) > [API key] (API 金鑰)。
  3. 請依照下列步驟設定 API 金鑰：
    • Name (名稱)：vertexaiapikey
    • 透過服務帳戶驗證 API 呼叫：已選取。
  4. 按一下「選取服務帳戶」。
  5. 選取您在上一個步驟中建立的服務帳戶，然後按一下「選取」。
  6. 按一下 [建立]。

提出第一個 API 要求

取得 API 金鑰後，請參閱 API 快速入門指南，瞭解如何使用 API 金鑰提出第一個要求。

選用：在本機設定 API 金鑰

如要進行初步測試，您可以將 API 金鑰硬式編碼，但這僅適用於暫時性使用，因為這不安全。本節的其餘部分將說明如何在本機將 API 金鑰設為不同作業系統的環境變數。

按一下即可展開操作說明

Linux/macOS

  1. 執行下列指令，查看您使用的是哪個指令列殼層：

    echo $SHELL

    輸出結果會與下列內容相似：

    /bin/bash

  2. 請執行下列任一操作，為 API 金鑰新增 shell 匯出變數：

    • 如果上一個步驟的輸出內容是 /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. 套用變更