本快速入门将向您介绍如何为所选语言安装 Google Gen AI SDK,然后发出您的第一个 API 请求。示例会根据您是使用 API 密钥还是应用默认凭证 (ADC) 向 Vertex AI 进行身份验证而略有不同。
选择身份验证方法:
准备工作
如果您尚未配置 ADC,请按照以下说明操作:
配置您的项目
选择项目、启用结算功能、启用 Vertex AI API 并安装 gcloud CLI:
-
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.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. -
Install the Google Cloud CLI.
-
如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. -
Install the Google Cloud CLI.
-
如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
-
如需初始化 gcloud CLI,请运行以下命令:
gcloud init
创建本地身份验证凭证
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
所需的角色
如需获得在 Vertex AI 中使用 Gemini API 所需的权限,请让您的管理员为您授予项目的 Vertex AI User (roles/aiplatform.user
) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
安装 SDK 并设置环境
在您的本地机器上,点击以下标签页之一,安装相应编程语言的 SDK。
Python Gen AI SDK
运行以下命令,安装并更新 Gen AI SDK for Python。
pip install --upgrade google-genai
设置环境变量:
# Replace the `GOOGLE_CLOUD_PROJECT_ID` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT_ID export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Go Gen AI SDK
运行以下命令,安装并更新 Go 版 Gen AI SDK。
go get google.golang.org/genai
设置环境变量:
# Replace the `GOOGLE_CLOUD_PROJECT_ID` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT_ID export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Node.js Gen AI SDK
运行以下命令,安装并更新 Node.js 版 Gen AI SDK。
npm install @google/genai
设置环境变量:
# Replace the `GOOGLE_CLOUD_PROJECT_ID` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT_ID export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
Java Gen AI SDK
运行以下命令,安装并更新 Gen AI SDK for Java。
Maven
将以下内容添加到 pom.xml
中:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>0.7.0</version>
</dependency>
</dependencies>
设置环境变量:
# Replace the `GOOGLE_CLOUD_PROJECT_ID` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT_ID export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
REST
设置环境变量:
GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT_ID GOOGLE_CLOUD_LOCATION=global API_ENDPOINT=YOUR_API_ENDPOINT MODEL_ID="gemini-2.5-flash" GENERATE_CONTENT_API="generateContent"
提交第一个请求
使用 generateContent
方法向 Vertex AI 中的 Gemini API 发送请求:
Python
Go
Node.js
Java
REST
如需发送此提示请求,请从命令行运行 curl 命令,或在应用中添加 REST 调用。
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://${API_ENDPOINT}/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/${GOOGLE_CLOUD_LOCATION}/publishers/google/models/${MODEL_ID}:${GENERATE_CONTENT_API}" -d $'{ "contents": { "role": "user", "parts": { "text": "Explain how AI works in a few words" } } }'
模型会返回回复。 请注意,系统分多个部分生成回复,其中每个部分会分别评估安全性。
生成图片
Gemini 可以通过对话方式生成和处理图片。您可以通过文本、图片或两者结合的方式向 Gemini 发出提示,以完成各种与图片相关的任务,例如图片生成和编辑。以下代码演示了如何根据描述性提示生成图片:
您必须在配置中添加 responseModalities: ["TEXT", "IMAGE"]
。这些模型不支持仅图片输出。
Python
Node.js
Java
图片理解
Gemini 还可以理解图片。以下代码使用上一部分中生成的图片,并使用其他模型来推断有关该图片的信息:
Python
Go
Node.js
Java
代码执行
Vertex AI 中的 Gemini API 代码执行功能可让模型生成和运行 Python 代码,并从结果中迭代学习,直到获得最终输出。Vertex AI 提供代码执行作为工具,类似于函数调用。利用此代码执行功能,您可以构建可受益于基于代码的推理并生成文本输出的应用。例如:
Python
Go
Node.js
Java
如需查看更多代码执行示例,请参阅代码执行文档。
后续步骤
现在,您已发出第一个 API 请求,不妨探索以下指南,了解如何为生产代码设置更高级的 Vertex AI 功能: