OpenAI 在 Google Cloud 上的接入

2026-11-19 15:38 更新

目前,通过 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。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号