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

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

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

注册以使用快速模式

Agent Platform 以快速模式提供给拥有 @gmail.com Google 账号的开发者：

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

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

如需注册以使用快速模式下的 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 快速模式 完整 Agent Platform
时间限制 90 天 无限制
可获得的服务 基本生成式 AI 服务。 所有 Google Cloud 服务，包括 Agent Platform。
数据源 Google 云端硬盘 中提供的所有数据源 Google Cloud。
Quota 免费层级限制。请参阅快速模式下的可用模型和速率限制。 标准随用随付限制。请参阅速率限制。
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 > Create prompt ，使用各种 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 标头中传递 API 密钥（例如 -H "x-goog-api-key: API_KEY"）。 如果您的客户端环境不允许您设置 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