通过 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。
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 API | Google 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。