快速模式下的 Gemini Enterprise Agent Platform 概览

借助 Gemini Enterprise Agent Platform 快速模式，您可以注册并开始在 Google Cloud上构建生成式 AI 应用。这种简化的设置体验通过简化组织、结算和项目管理，简化了对 Google Cloud API 的访问。

如需详细了解 Agent Platform 快速模式，请参阅 Google Cloud快速模式常见问题解答。

注册快速模式

拥有 @gmail.com Google 账号的开发者可以使用 Agent Platform 的快速模式：

  • 新用户： Google Cloud 的新用户可以注册免费层级的快速模式账号，在指定配额内免费试用 Agent Platform 最多 90 天。您无需提供结算信息即可注册免费层级。您可以通过添加结算账号 升级到付费层级

    快速模式下的 Agent Platform 与 Google Cloud Free 计划是分开的，无法通过该计划使用。如果您使用的是 Google Cloud Free Program，请参阅使用入门部分中的其他快速入门。

如需在快速模式下注册 Agent Platform，请从 Google Cloud 控制台打开快速模式：

前往“快速模式”

设置完成后，您可以按照以下教程之一开始在快速模式下使用 Agent Platform：

了解快速模式下的 Agent Platform

当您注册快速模式时， Google Cloud 会代表您启用 API。此过程在后台进行，因此您无需手动配置资源即可开始使用 Agent Platform。

注册快速模式后，您将可以使用以下功能：

  • Agent Studio 的核心功能。测试和自定义发送给不同生成式 AI 模型的提示，并获取相应的代码以在您的应用中使用。
  • API 密钥。对来自应用的请求进行身份验证。
  • 新用户可在 90 天内 Google Cloud 免费试用。在面向新 Google Cloud 用户的免费层级 90 天期限内，您可以在配额上限内免费使用支持快速模式的 Agent Platform API。您无需提供结算信息。您可以随时通过启用结算功能来提高配额上限。

如果您是现有 Google Cloud 用户，或者在启用结算功能后，90 天免费层级将被移除。您需要改用付费层级，才能获享更高的配额上限和更多 Google Cloud 功能。随着配额增加，您只需按实际用量付费。您可以随时选择结束快速模式，并开始使用所有 Google Cloud 服务和功能。

下表列出了快速模式体验与完整 Agent Platform 体验之间的差异：

项 免费层级中的 Agent Platform 快速模式 Full Agent Platform
时间限制 90 天 无限制
可获得的服务 基本的生成式 AI 服务。 所有 Google Cloud 服务，包括 Agent Platform。
数据源 Google 云端硬盘 Google Cloud中提供的所有数据源。
配额 免费层级限制。请参阅快速模式下的可用模型和速率限制。 标准随用随付限制。请参阅速率限制。
API 端点的标准格式 使用不含项目 ID 或位置信息的全球端点，并在 x-goog-api-key HTTP 标头（或 key 查询参数）中传递 API 密钥。例如：
https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent 		指定项目 ID 和位置。例如：
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

快速模式下的可用模型和速率限制

您可以在快速模式下试用多种模型，包括 Gemini Flash 模型。下表列出了在快速模式下可用的模型及其速率限制：

模型类别 可用模型 每分钟请求数上限
Gemini gemini-3-pro-image 动态
gemini-3.1-flash-image 动态
gemini-3.1-pro-preview 动态
gemini-3-flash-preview 动态
gemini-2.5-pro 10
gemini-2.5-flash-image 10
gemini-2.5-flash 10
gemini-2.5-flash-lite 10

快速模式仅支持上表中列出的模型。 快速模式不支持专用 Gemini Live API 模型，例如 Gemini 3.8 Live (gemini-3.8-live) 和 Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio)，并且在快速模式下，Google Cloud 控制台中不提供 Gemini Live API。如需使用受支持的 Gemini Live API 模型，请从快速模式升级到标准 Google Cloud账号。

Agent Platform 快速模式工作流

您只需三个步骤，即可开始从应用向 Agent Platform API 发送请求：

  1. 注册快速模式后，使用 Agent Studio 试用 Agent Platform 功能：

    前往 Agent Studio

    例如，选择 Agent Studio > 创建提示词，即可使用各种 Gemini 模型创建和优化多模态提示词。

  2. 获取您通过界面实现的内容的代码。

    在提示页面上，依次点击使用代码构建 > 获取代码。系统会打开一个面板，其中显示的代码会以编程方式发送您在界面中实现的相同请求。您可以获取编程语言或 curl 的代码。您可以使用 Google Colab 试用 Python 代码。

  3. 使用 API 密钥向 Agent Platform API 进行身份验证。

    在 Google Cloud 控制台的快速模式下，依次打开 API 和服务 > 凭证：

    进入“凭据”页面

    然后，将 Generative Language API 密钥复制到代码中 "YOUR_API_KEY" 所在的位置。例如：

    Python

    Google Gen AI SDK for Python 可在 PyPI 和 GitHub 上获取：

    如需了解详情，请参阅 Python SDK 参考文档（在新标签页中打开）。 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

快速模式有何不同

Agent Platform 快速模式提供生成式 AI 的部分功能。因此，如果您在注册时选择了快速模式，则部分 Agent Platform 文档可能不适用。如需详细了解快速模式下可用的 API 端点，请参阅 快速模式下的 Agent Platform REST API 参考文档。

此外， Google Cloud 中的客户通常使用组织和项目来处理资源（例如，调用 API 端点）。在快速模式下使用 Agent Platform 时，您无需担心组织或项目。不过，在您以快速模式使用 Agent Platform 时，可能会在参考的一些 Google Cloud 文档中看到这些概念。您仍然可以使用这些文档，但请忽略其中提及组织和项目的概念和说明。此外，您在以快速模式注册时选择的位置将贯穿您的整个体验。

在快速模式下调用 REST API 端点时，请使用快速模式的全局端点格式，并使用 API 密钥进行身份验证：

标准端点网址 https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
快速模式下的端点网址 https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

在快速模式下发送 REST 请求时，请注意以下端点和身份验证详细信息：

  • 发布方模型路径 ({model})：在Agent Platform 快速模式 REST API 参考文档中，https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent 和 https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent 等端点模板使用 {model} 表示完整的发布方模型资源路径 (publishers/google/models/MODEL_ID)。两者都解析为相同的端点网址。
  • API 密钥身份验证标头：无需将 API 密钥作为查询参数传递。在 x-goog-api-key HTTP 标头（例如 -H "x-goog-api-key: API_KEY"）中传递 API 密钥。如果您的客户端环境不允许您设置 HTTP 标头，则可以改为传递 key 系统查询参数 (?key=API_KEY)。如需了解详情，请参阅使用 API 密钥。

查看和管理 API 密钥

如需向支持快速模式的 Agent Platform API 端点进行身份验证，请使用在注册期间为您创建的 API 密钥或您在快速模式下创建的任何密钥。API 密钥是一个加密字符串，在您以快速模式注册时会自动生成。您可以在 API 和服务页面上查看和管理这些 API 密钥。

如需详细了解管理 API 密钥的最佳实践，请参阅管理 API 密钥的最佳实践。

如需查看和管理您的 API 密钥，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 API 密钥页面：

    打开“API 密钥”

启用和管理结算功能

您可以通过启用结算功能来提高配额并移除 90 天限制。

启用结算功能后，您只需为实际用量付费。您还可以保存提示，并在 Google Cloud 控制台中使用其他设置，这些设置在未启用结算功能时会灰显。

如需管理结算，请执行以下操作：

  1. 在快捷模式下，前往 Agent Studio 的“概览”页面。

    前往 Agent Studio

  2. 在 Google Cloud 控制台的快速模式下，打开结算：

    转到“结算”

  3. 管理您的结算账号。

开始使用所有 Google Cloud 功能和服务

快速模式旨在帮助您快速上手。当您准备好使用其他Google Cloud 服务或需要更好地控制环境时，可以将快速模式账号转换为标准 Google Cloud 账号。此过程有时称为“升级”。

您可以通过升级快速模式账号，开始在项目中使用Google Cloud 中提供的所有功能和服务。

如需从快速模式升级，请执行以下操作：

  1. 在快捷模式下前往 Agent Studio 概览页面。

    前往 Agent Studio

  2. 点击立即激活，然后按照说明操作。

从快速模式升级后，在调用 REST API 端点时，请指定项目 ID 和位置，而不是 API 密钥。例如：

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent