如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

在 Google Cloud 上使用 OpenAI 模型

通过 Google Cloud 访问 OpenAI 模型的功能目前处于非公开预览阶段。如需在项目中使用这些模型,请申请访问权限。

您可以通过 Google Cloud 在 Gemini 平台上使用 OpenAI 模型,使用费用计入您的 Google Cloud 账号。这些模型在 Google Cloud 的安全边界内运行,您的组织通过 Google Cloud IAM 管理访问权限。

本指南介绍如何通过 Google Cloud 发送 Responses API 请求,以及 Google Cloud 与 OpenAI 官方 API 在功能支持方面的差异。

可用模型如下:

模型 模型 ID
GPT-6 Luna gpt-6-luna
GPT-6.1 Sol gpt-6.1-sol
GPT-6.1 Terra gpt-6.1-terra
GPT-6 Astra gpt-6-astra

准备工作

在您发送请求之前,Google Cloud 管理员需要完成以下操作:

  • 为项目启用结算,安排项目审批,并与结算管理员协调接受 Google Cloud Marketplace 的专属报价。
  • 启用 Vertex AI API(aiplatform.googleapis.com),并在 Model Garden 中启用模型、接受模型条款。
  • 如果组织政策限制模型访问,请在该政策中允许访问此模型。
  • 向发送请求的用户或服务账号授予调用模型的权限,例如为其分配 roles/aiplatform.user 角色。

项目准备就绪后,请向管理员索取项目 ID。

首次调用 API

在本地开发时,请安装 Google Cloud CLI,然后使用有权访问该项目的 Google 账号登录:

gcloud auth application-default login

在接下来要发送请求的终端中获取访问令牌:

export GOOGLE_CLOUD_ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"

访问令牌过期后,再次运行此命令即可使用已保存的登录凭据获取新令牌。

使用 cURL 或 OpenAI SDK 发送请求时,请将 your-project-id 替换为您的项目 ID。

在 Google Cloud 上发送 Responses API 请求
PROJECT_ID="your-project-id"
PROJECT_URL="https://aiplatform.googleapis.com/v1/projects/$PROJECT_ID"

curl --fail-with-body "$PROJECT_URL/locations/global/publishers/openai/v1/responses" \
  -H "Authorization: Bearer $GOOGLE_CLOUD_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "input": "Write a one-sentence bedtime story about a unicorn.",
    "store": false
  }'

如果希望通过 Google 身份验证库获取访问令牌,省去在终端中导出令牌的步骤,请参阅 Google 的入门指南,了解如何使用应用默认凭据(ADC)和排查 API 错误。

功能支持情况

下表列出了 Google Cloud 和 OpenAI 官方 API 对各项功能的支持情况。

功能OpenAI APIGoogle Cloud

API 请求

文本生成支持支持
通过 HTTP 流式传输响应(SSE)支持支持
Responses API 端点支持支持
响应的 Token 用量支持支持
输入 Token 计数端点支持不支持
实时 WebSocket 连接支持不支持
后台请求支持不支持
恢复后台流式传输支持不支持
Chat Completions API支持不支持
批处理支持不支持

输出与推理

使用 JSON 模式定义的结构化输出支持支持
JSON 模式支持支持
推理强度支持支持
加密推理支持支持
推理摘要支持不支持

工具与集成

客户端函数调用支持支持
并行工具调用支持支持
结构化函数参数支持支持
自定义工具支持支持自由格式输入或使用正则表达式约束输入
客户端工具搜索支持支持
在客户端运行的 MCP 工具和带命名空间的工具支持支持
客户端 Shell 工具支持支持
托管式网页搜索支持不支持
托管式文件搜索和向量存储支持不支持
托管式代码执行支持不支持
服务端远程 MCP支持不支持

文档与媒体

PDF 文本提取支持支持
内联图像输入支持支持
图像生成支持不支持

对话状态

继续已保存的对话支持支持
以无状态方式继续对话支持支持
对话压缩支持支持
显式控制提示词缓存支持支持

数据保留

您的提示词和响应不会用于训练 OpenAI 模型。默认最多保留 30 天。

如果需要零数据保留(ZDR),请在接入期间联系您的 OpenAI 或 Google Cloud 代表,并等待对方确认可以提供支持。在请求中设置 store: false 不会启用 ZDR。