このページは Cloud Translation API によって翻訳されました。

Gemini を使ってみる

このページでは、デベロッパーが Gemini モデルを使用するために Google Distributed Cloud（GDC）のエアギャッププロジェクトを設定する方法について説明します。このプロセスには、プロジェクトの作成、Gemini API の有効化、クライアントライブラリのインストール、環境変数の定義、認証情報の認証が含まれます。Gemini を初めてご利用になる場合は、Gemini の機能の詳細をご覧ください。

Gemini の使用を開始するには、次のように GDC コンソールと gdcloud CLI を使用します。

GDC コンソール: Gemini API を有効にして、モデルのステータスとエンドポイントを表示します。
gdcloud CLI: サービスアカウントの構成、クライアントライブラリのインストール、API リクエストの認証を行います。

プロジェクトを作成する

Distributed Cloud のリソース階層内にプロジェクトを作成すると、共同編集者、有効化された API、認証情報、アクセス制御などのリソースが整理されます。

Gemini は、GDC の Vertex AI で提供される生成 AI モデルの 1 つです。したがって、プロジェクトを作成するには、Vertex AI 用にプロジェクトを設定するをご覧ください。API 呼び出しを行うには、プロジェクト ID が必要です。

デベロッパー権限をリクエストする

Gemini の機能にアクセスし、リクエストの認証と認可用の API トークンを生成するには、プロジェクトで適切なロールが必要です。

プロジェクトの IAM 管理者に、プロジェクトの Namespace 内のユーザーまたはサービスアカウントに関連付けられた Gemini ロールのいずれかを付与するよう依頼します。Gemini ロールの詳細については、IAM 権限を準備するをご覧ください。

Gemini API を有効にする

プロジェクトで Gemini API を有効にする必要があります。有効にすると、Gemini API のサービスステータスとエンドポイントを表示できます。

クライアントライブラリのインストール

クライアントライブラリは 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 リクエストを認証するをご覧ください。