クイックスタート: Vertex AI Gemini API を使用してテキストを生成する
このクイックスタートでは、次のマルチモーダル リクエストを Vertex AI Gemini API に送信し、レスポンスを表示します。
- テキスト プロンプト
- プロンプトと画像
- プロンプトと動画ファイル(音声トラック付き)
このクイックスタートは、ローカル環境のプログラミング言語 SDK または REST API を使用して完了できます。
前提条件
このクイックスタートを完了するには、次の操作が必要です。
- Google Cloud プロジェクトを設定して Vertex AI API を有効にする
- ローカルマシンで:
- Google Cloud CLI をインストール、初期化、認証する
- 言語の SDK をインストールする
Google Cloud プロジェクトの設定
Google Cloud プロジェクトを設定し、Vertex AI API を有効にします。
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
Google Cloud CLI を設定する
ローカルマシンで Google Cloud CLI を設定して認証します。Google AI Studio の Gemini API に精通している場合は、Vertex AI Gemini API では API キーではなく、Identity and Access Management を使用してアクセスを管理することに注意してください。
-
Google Cloud CLI をインストールして初期化します。
-
すでに gcloud CLI をインストールしている場合は、このコマンドを実行して
gcloud
コンポーネントが更新されていることを確認します。gcloud components update
-
gcloud CLI で認証するには、次のコマンドを実行してローカルのアプリケーションのデフォルト認証情報(ADC)ファイルを生成します。コマンドで起動されたウェブフローを使用して、ユーザー認証情報を提供します。
gcloud auth application-default login
詳細については、アプリケーションのデフォルト認証情報を設定するをご覧ください。
プログラミング言語の SDK を設定する
ローカルマシンで、次のいずれかのタブをクリックして、プログラミング言語の SDK をインストールします。
Python
次のコマンドを実行して、Vertex AI SDK for Python をインストールして更新します。
pip3 install --upgrade "google-cloud-aiplatform>=1.64"
Node.js
次のコマンドを実行して、Node.js 用の aiplatform
SDK をインストールまたは更新します。
npm install @google-cloud/vertexai
Java
google-cloud-vertexai
を依存関係として追加するには、環境に適したコードを追加します。
BOM ありの Maven
pom.xml
に次の HTML を追加します。
<dependencyManagement> <dependencies> <dependency> <artifactId>libraries-bom</artifactId> <groupId>com.google.cloud</groupId> <scope>import</scope> <type>pom</type> <version>26.34.0</version> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies>
BOM なしの Maven
pom.xml
に次のように追加します。
<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency>
BOM なしの Gradle
build.gradle
に次の行を追加します。
implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
Go
利用可能な Vertex AI API Go パッケージを確認して、プロジェクトのニーズに最適なパッケージを判断します。
(推奨)
cloud.google.com/go/vertexai
vertexai
は人の手で作成されたパッケージで、一般的な機能へのアクセスを提供します。Vertex AI API を使ってアプリを構築するほとんどのデベロッパーの方に、足がかりとしておすすめのパッケージです。このパッケージにまだ含まれていない機能を利用するには、自動生成された
aiplatform
パッケージを使用してください。このパッケージをインストールするには、次のコマンドを実行します。
go get cloud.google.com/go/vertexai
cloud.google.com/go/aiplatform
aiplatform
は自動生成されたパッケージです。このパッケージは、人の手によって作成された
vertexai
パッケージではまだ提供されていない Vertex AI API 機能を使用する必要があるプロジェクトを対象としています。このパッケージをインストールするには、次のコマンドを実行します。
go get cloud.google.com/go/aiplatform
C#
NuGet から Google.Cloud.AIPlatform.V1
パッケージをインストールします。プロジェクトにパッケージを追加する方法を選択します。たとえば、Visual Studio でプロジェクトを右クリックし、[NuGet パッケージの管理...] を選択します。
REST
次のように入力して、環境変数を構成します。
PROJECT_ID
は、Google Cloud プロジェクトの ID に置き換えます。MODEL_ID="gemini-1.5-flash-002" PROJECT_ID="PROJECT_ID"
Google Cloud CLI を使用して、次のコマンドを実行してエンドポイントをプロビジョニングします。
gcloud beta services identity create --service=aiplatform.googleapis.com --project=${PROJECT_ID}
Vertex AI Gemini API にプロンプトを送信する
次のコードを使用して、Vertex AI Gemini API にプロンプトを送信します。このサンプルは、花専門店の有効な名前のリストを返します。
コードは、コマンドラインから、IDE を使用して、またはアプリケーションにコードを組み込んで実行できます。
Python
プロンプト リクエストを送信するには、Python ファイル(.py
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
の値を Google Cloud プロジェクトの ID に設定します。値を更新したら、コードを実行します。
Node.js
プロンプト リクエストを送信するには、Node.js ファイル(.js
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
Java
プロンプト リクエストを送信するには、Java ファイル(.java
)を作成し、次のコードをファイルにコピーします。your-google-cloud-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
Go
プロンプト リクエストを送信するには、Go ファイル(.go
)を作成し、次のコードをファイルにコピーします。projectID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
C#
プロンプト リクエストを送信するには、C# ファイル(.cs
)を作成し、次のコードをファイルにコピーします。your-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
REST
このプロンプト リクエストを送信するには、コマンドラインから curl コマンドを実行するか、アプリに REST 呼び出しを含めます。
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "text": "What\'s a good name for a flower shop that specializes in selling bouquets of dried flowers?" } ] } }'
プロンプトと画像を Vertex AI Gemini API に送信する
次のコードを使用して、テキストと画像を含むプロンプトを Vertex AI Gemini API に送信します。このサンプルは、指定された画像(Java サンプルの画像)の説明を返します。
Python
プロンプト リクエストを送信するには、Python ファイル(.py
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
の値を Google Cloud プロジェクトの ID に設定します。値を更新したら、コードを実行します。
Node.js
プロンプト リクエストを送信するには、Node.js ファイル(.js
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
Java
プロンプト リクエストを送信するには、Java ファイル(.java
)を作成し、次のコードをファイルにコピーします。your-google-cloud-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
Go
プロンプト リクエストを送信するには、Go ファイル(.go
)を作成し、次のコードをファイルにコピーします。projectID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
C#
プロンプト リクエストを送信するには、C# ファイル(.cs
)を作成し、次のコードをファイルにコピーします。your-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
REST
このプロンプト リクエストは IDE から送信できます。また、必要に応じて REST 呼び出しをアプリケーションに埋め込むこともできます。
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
モデルによりレスポンスが返されます。 レスポンスはセクション内で生成され、各セクションの安全性が個別に評価されます。
Vertex AI Gemini API にプロンプトと動画を送信する
次のコードを使用して、テキスト、音声、動画を含むプロンプトを Vertex AI Gemini API に送信します。このサンプルは、音声トラックの重要な部分を含む、指定された動画の説明を返します。
このプロンプト リクエストは、コマンドライン、IDE、またはアプリケーションに REST 呼び出しを含めることで送信できます。
Python
プロンプト リクエストを送信するには、Python ファイル(.py
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
の値を Google Cloud プロジェクトの ID に設定します。値を更新したら、コードを実行します。
Node.js
プロンプト リクエストを送信するには、Node.js ファイル(.js
)を作成し、次のコードをファイルにコピーします。PROJECT_ID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
Java
プロンプト リクエストを送信するには、Java ファイル(.java
)を作成し、次のコードをファイルにコピーします。your-google-cloud-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
Go
プロンプト リクエストを送信するには、Go ファイル(.go
)を作成し、次のコードをファイルにコピーします。projectID
は、Google Cloud プロジェクトの ID に置き換えます。値を更新したら、コードを実行します。
C#
プロンプト リクエストを送信するには、C# ファイル(.cs
)を作成し、次のコードをファイルにコピーします。your-project-id
を Google Cloud プロジェクト ID に設定します。値を更新したら、コードを実行します。
REST
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "video/mp4", "fileUri": "gs://cloud-samples-data/generative-ai/video/pixel8.mp4" } }, { "text": "Provide a description of the video. The description should also contain anything important which people say in the video." } ] } }'
モデルによりレスポンスが返されます。 レスポンスはセクション内で生成され、各セクションの安全性が個別に評価されます。
次のステップ
- Vertex AI の Gemini API の詳細を確認する。
- Python、Node.js、Java、Go、C# の Vertex AI Gemini API SDK リファレンスを確認する。
- Vertex AI の Model API for Gemini を確認する。
- OpenAI ライブラリを使用して Vertex AI モデルを呼び出す方法を学習する。