OpenAI 在 Google Cloud 上的接入
目前,通过 Google Cloud 访问 OpenAI 模型处于私有预览阶段。请为项目申请访问。
你可以在 Google Cloud 的 Gemini 平台使用 OpenAI 模型。费用计入 Google Cloud 账户,模型在 Google Cloud 安全边界内运行,组织通过 Google Cloud IAM 管理访问权限。
| 模型 | 模型 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 管理员完成以下配置。
- 为项目启用结算并安排项目审批。由结算管理员接受 Marketplace 私有优惠。
- 启用 Vertex AI API(
aiplatform.googleapis.com),并在 Model Garden 中启用模型、接受模型条款。 - 若组织策略限制模型访问,请在模型访问策略中启用所需模型。
- 给调用模型的用户或服务账号授权,例如分配
roles/aiplatform.user。
项目就绪后,向管理员获取项目 ID。
发出第一个 API 请求
本地开发时,安装 Google Cloud CLI,使用有权访问项目的 Google 账号登录。
## 登录 Google Cloud,生成本地应用默认凭据
gcloud auth application-default login
在即将发送请求的终端中获取访问令牌。令牌到期后,使用已保存的登录凭据重新执行这条取令牌命令。
## 从已保存的登录凭据获取短期访问令牌
export GOOGLE_CLOUD_ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
使用 cURL 或 OpenAI SDK发出 Responses API 请求。将示例的 your-project-id 换成实际项目 ID。
cURL
## 将项目 ID 换成实际值,再使用 Google Cloud 令牌发送请求
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": "用一句话写一个关于独角兽的睡前故事。",
"store": false
}'
TypeScript
// 用 Google Cloud 访问令牌与服务端点初始化客户端
import OpenAI from "openai";
const projectId = "your-project-id";
const client = new OpenAI({
apiKey: process.env.GOOGLE_CLOUD_ACCESS_TOKEN,
baseURL: `https://aiplatform.googleapis.com/v1/projects/${projectId}/locations/global/publishers/openai/v1`,
});
const response = await client.responses.create({
model: "gpt-6-luna",
input: "用一句话写一个关于独角兽的睡前故事。",
store: false,
});
console.log(response.output_text);
Python
## 用 Google Cloud 访问令牌与服务端点初始化客户端
import os
from openai import OpenAI
project_id = "your-project-id"
client = OpenAI(
api_key=os.environ["GOOGLE_CLOUD_ACCESS_TOKEN"],
base_url=(
f"https://aiplatform.googleapis.com/v1/projects/{project_id}"
"/locations/global/publishers/openai/v1"
),
)
response = client.responses.create(
model="gpt-6-luna",
input="用一句话写一个关于独角兽的睡前故事。",
store=False,
)
print(response.output_text)
Go
// 用 Google Cloud 访问令牌与服务端点初始化客户端
package main
import (
"context"
"fmt"
"os"
"github.com/openai/openai-go/v3"
"github.com/openai/openai-go/v3/option"
"github.com/openai/openai-go/v3/responses"
)
func main() {
ctx := context.Background()
projectID := "your-project-id"
client := openai.NewClient(
option.WithAPIKey(os.Getenv("GOOGLE_CLOUD_ACCESS_TOKEN")),
option.WithBaseURL("https://aiplatform.googleapis.com/v1/projects/"+projectID+"/locations/global/publishers/openai/v1"),
)
response, err := client.Responses.New(ctx, responses.ResponseNewParams{
Model: "gpt-6-luna",
Input: responses.ResponseNewParamsInputUnion{
OfString: openai.String("用一句话写一个关于独角兽的睡前故事。"),
},
Store: openai.Bool(false),
})
if err != nil {
panic(err)
}
fmt.Println(response.OutputText())
}
如果希望通过 Google 的身份验证库获取令牌,可参照 Google Cloud 入门示例使用应用默认凭据(ADC)并排查 API 错误。
功能支持
下表对比 OpenAI API 与 Google Cloud 接入方式的功能支持情况。
API 请求
| 功能 | OpenAI API | Google Cloud |
|---|---|---|
| 文本生成 | 支持 | 支持 |
| 通过 HTTP 流式返回响应(SSE) | 支持 | 支持 |
| Responses API 端点 | 支持 | 支持 |
| 响应词元用量 | 支持 | 支持 |
| 输入词元计数端点 | 支持 | 不支持 |
| Realtime WebSocket 连接 | 支持 | 不支持 |
| 后台请求 | 支持 | 不支持 |
| 后台流式响应续传 | 支持 | 不支持 |
| Chat Completions API | 支持 | 不支持 |
| 批处理 | 支持 | 不支持 |
输出与推理
| 功能 | OpenAI API | Google Cloud |
|---|---|---|
| 基于 JSON Schema 的结构化输出 | 支持 | 支持 |
| JSON 模式 | 支持 | 支持 |
| 推理力度 | 支持 | 支持 |
| 加密推理 | 支持 | 支持 |
| 推理摘要 | 支持 | 不支持 |
工具与集成
| 功能 | OpenAI API | Google Cloud |
|---|---|---|
| 客户端函数调用 | 支持 | 支持 |
| 并行工具调用 | 支持 | 支持 |
| 结构化函数参数 | 支持 | 支持 |
| 自定义工具 | 支持 | 支持自由格式输入或正则表达式约束 |
| 客户端工具搜索 | 支持 | 支持 |
| 客户端运行的 MCP 和命名空间工具 | 支持 | 支持 |
| 客户端 Shell 工具 | 支持 | 支持 |
| 托管网页搜索 | 支持 | 不支持 |
| 托管文件搜索和向量存储 | 支持 | 不支持 |
| 托管代码执行 | 支持 | 不支持 |
| 服务端远程 MCP | 支持 | 不支持 |
文档和媒体
| 功能 | OpenAI API | Google Cloud |
|---|---|---|
| PDF 文本提取 | 支持 | 支持 |
| 内联图像输入 | 支持 | 支持 |
| 图像生成 | 支持 | 不支持 |
会话状态
| 功能 | OpenAI API | Google Cloud |
|---|---|---|
| 继续已保存的会话 | 支持 | 支持 |
| 无状态继续会话 | 支持 | 支持 |
| 会话压缩 | 支持 | 支持 |
| 显式提示词缓存控制 | 支持 | 支持 |
数据保留
提示词和响应不会用于训练 OpenAI 模型。默认最长保留 30 天。
如需零数据保留(ZDR),请在接入阶段联系 OpenAI 或 Google Cloud 对接人员确认支持情况。请求中的 store: false 不会启用 ZDR。

TRAE-AI编程


更多建议: