取得 Google Cloud API 金鑰

本指南說明如何取得 Google Cloud API 金鑰，以便在 Vertex AI 上使用 Gemini，涵蓋下列主題：

• 驗證選項：比較使用 API 金鑰與應用程式預設憑證。
• 取得 API 金鑰 (新使用者)：如果您沒有 Google Cloud 帳戶，如何快速取得 API 金鑰。
• 取得 API 金鑰 (現有使用者)：如果您已有 Google Cloud 帳戶，請參閱這篇文章，瞭解如何產生標準 API 金鑰。

驗證選項

如要使用 Gemini 版 Vertex AI，請先完成驗證。下表比較這兩種主要驗證方法。

方法	說明	優點	缺點	適用情境
Google Cloud API 金鑰	已加密的簡易字串，可授予 Google Cloud API 的存取權。	設定簡單快速。	安全性較低，需要謹慎管理，以免暴露風險。	快速入門、原型設計和初步開發。
應用程式預設憑證 (ADC)	這項策略會根據應用程式環境自動尋找憑證。	更安全：憑證不會經過硬式編碼。自動管理憑證輪替。	需要更多初始設定，並瞭解 IAM。	實際工作環境和高度要求安全性的環境。

建議您使用 API 金鑰進行初步測試，並使用應用程式預設憑證進行實際工作環境。本頁面說明如何根據您是否已有 Google Cloud 帳戶，取得 Google Cloud API 金鑰。

選取你是否擁有 Google Cloud 帳戶：

否，我沒有帳戶 是，我有帳戶

---

建立 Google Cloud API 金鑰

如果您已有 Google Cloud 帳戶，請按照下列操作說明取得標準 Google Cloud API 金鑰。

事前準備

概念

• 服務帳戶：一種特殊的 Google 帳戶，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。
• API 金鑰：已加密的簡易字串，用於識別 Google 專案的配額、帳單及監控等功能。
• IAM (身分與存取權管理)：定義哪些使用者 (身分) 擁有哪些資源的存取權 (角色)。

必要條件

選取專案、啟用帳單，並啟用 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.

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.

Enable the API

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

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.

Enable the API

步驟 1：啟用服務帳戶 API 金鑰建立功能

重要事項：如要執行這個步驟，您的使用者帳戶必須具備機構政策管理員角色。如果沒有這個角色或無法進行這項設定，請改用應用程式預設憑證。

1. 開啟「IAM 與管理」>「機構政策」。
2. 在政策清單中，篩選名為 iam.managed.disableServiceAccountApiKeyCreation 的政策。
3. 依序點選「動作」>「編輯政策」。
4. 在「政策來源」下方，選取「覆寫父項政策」，然後按一下「新增規則」。
5. 在「Enforcement」(強制執行) 下方，選取「Off」(關閉)。
6. 按一下 [完成]。
7. 按一下「設定政策」。在隨即彈出的對話方塊中，再次點選「設定政策」。

步驟 2：建立新的服務帳戶

1. 開啟「IAM 與管理」>「服務帳戶」。
2. 按一下「建立服務帳戶」。
3. 請按照下列步驟設定服務帳戶：
   • 服務帳戶名稱：vertex-ai-runner
   • 服務帳戶 ID：vertexairunner
4. 按一下「建立並繼續」。
5. 在「權限」下方，按一下「選取角色」，然後從選單中選取「Vertex AI Platform Express 使用者」。
6. 按一下「繼續」。
7. 按一下 [完成]。

步驟 3：建立 API 金鑰

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

發出第一項 API 要求

取得 API 金鑰後，請參閱 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 中新增下列程式碼，並將 <var>YOUR_API_KEY</var> 替換為您的金鑰：

        export GEMINI_API_KEY=<var>YOUR_API_KEY</var>

     3. 儲存檔案，然後執行下列指令來套用變更：

        source ~/.bashrc

   • 如果您的殼層是 /bin/zsh：

     1. 開啟 .zshrc：

        touch ~/.zshrc
        open ~/.zshrc

     2. 在 .zshrc 中新增下列程式碼，並將 <var>YOUR_API_KEY</var> 替換為您的金鑰：

        export GEMINI_API_KEY=<var>YOUR_API_KEY</var>

     3. 儲存檔案，然後執行下列指令來套用變更：

        source ~/.zshrc

Windows

1. 開啟「開始」選單，然後搜尋「環境變數」。
2. 按一下「編輯系統環境變數」。
3. 在「系統內容」視窗中，按一下「環境變數」按鈕。
4. 在「使用者變數」部分，按一下「新增...」。
5. 在「變數名稱」中輸入 GEMINI_API_KEY。
6. 在「變數值」中貼上 API 金鑰。
7. 在所有開啟的視窗中按一下「確定」，即可套用變更。
8. 重新啟動所有開啟的終端機或命令提示字元視窗，變更才會生效。

---

警告：請務必妥善保管 API 金鑰。使用 API 金鑰時，請注意下列事項：

• 如果是正式版應用程式， Google Cloud 建議使用應用程式預設憑證，以更安全的方式進行驗證。
• Vertex AI 會使用 API 金鑰進行授權。如果其他人取得您的 API 金鑰，就能使用您專案的配額進行呼叫，這可能會導致配額用盡或產生額外費用，還可能存取您調整過的模型和檔案。
• 新增 API 金鑰限制有助於限制每個 API 金鑰可用的介面區域。
• 您有責任妥善保管 API 金鑰。
  • 請不要將 API 金鑰簽入原始碼控管。
  • 用戶端應用程式 (Android、Swift、網頁和 Dart/Flutter) 可能會洩漏 API 金鑰。我們不建議使用 Google AI 用戶端 SDK，直接從行動和網頁應用程式呼叫 API。

如需一般最佳做法，請參閱這篇有關 API 金鑰安全性的支援文章。