本頁面由 Cloud Translation API 翻譯而成。

開始使用 Gemini

本頁面可協助開發人員設定 Google Distributed Cloud (GDC) 實體隔離專案，以使用 Gemini 模型。這個程序包括建立專案、啟用 Gemini API、安裝用戶端程式庫、定義環境變數，以及驗證憑證。如果你是 Gemini 新手，請進一步瞭解 Gemini 的功能。

您可以使用 GDC 控制台和 gdcloud CLI 開始使用 Gemini，步驟如下：

建立專案

在 Distributed Cloud 資源階層中建立專案，即可整理資源，包括協作者、已啟用的 API、驗證憑證和存取權控管。

Gemini 是 GDC 上的 Vertex AI 提供的生成式 AI 模型之一。因此，如要建立專案，請參閱「設定 Vertex AI 專案」。進行 API 呼叫時，您需要專案 ID。

您必須在專案中具備適當的角色，才能存取 Gemini 功能，並產生 API 權杖來驗證及授權要求。

請專案 IAM 管理員在專案命名空間中，將其中一個相關聯的 Gemini 角色授予使用者或服務帳戶。如要瞭解 Gemini 角色，請參閱「準備 IAM 權限」。

用戶端程式庫支援 Python 程式設計語言。建議使用這些用戶端程式庫呼叫 Gemini API，因為這樣存取 API 會更輕鬆。

如要使用與 OpenAI 相容的 Python SDK，請安裝 OpenAI SDK 和其他必要的 Python 程式庫：

pip install openai
pip install absl-py
pip install typing
pip install protobuf

安裝用戶端程式庫後，您就可以透過 Python 指令碼與 API 互動。

如果您在專案中設定服務帳戶，以透過程式設計方式發出已授權的 API 呼叫，可以在 Python 指令碼中定義環境變數，存取服務帳戶金鑰等值。

請按照下列步驟，在 Python 指令碼中設定必要環境變數：

建立 Python 指令碼。
在 Python 指令碼中新增下列程式碼：
正式版
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
將 APPLICATION_DEFAULT_CREDENTIALS_FILENAME 替換為包含您在專案中建立的服務帳戶金鑰的 JSON 檔案名稱，例如 my-service-key.json。
開發
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
更改下列內容：
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME：JSON 檔案的名稱，其中包含您在專案中建立的服務帳戶金鑰，例如 my-service-key.json。
- CERT_NAME：憑證授權單位 (CA) 憑證檔案的名稱，例如 org-1-trust-bundle-ca.cert。詳情請參閱「在開發環境中產生信任組合 CA 憑證檔案」。
為 Python 指令碼命名並儲存。
執行 Python 指令碼來設定環境變數：
```
python SCRIPT_NAME
```
將 SCRIPT_NAME 替換成您為 Python 指令碼提供的名稱。

開始使用 Gemini API 之前，您必須先驗證用戶端憑證，並要求專案資源的帳戶存取權。詳情請參閱「驗證 API 要求」。