OpenAI 模型登陆 Google Cloud：Vertex AI 上的 Responses API 与 SDK vertex() 接入

OpenAI 模型正在走上一条新的分发渠道。2026-10-21，OpenAI 官方公告与两家官方 SDK 的同日更新把这件事从传闻变成了可执行的事实：openai-python v3.36.0 与 openai-node v7.41.0 各自合入了一个 vertex() provider，让标准的 OpenAI / AsyncOpenAI 客户端把 Responses API 请求直接发往 Google Cloud Vertex AI。本文按"公告说了什么、SDK 怎么配、边界在哪、什么还没说"四步拆解，全部参数级事实出自当次加载的 release notes、PR 与 tag 内文档。

1. 公告说了什么

官方新闻 RSS 在 2026-10-21 12:00 GMT 出现条目 "OpenAI models are coming to Google Cloud"，其描述全文为：

OpenAI and Google Cloud are bringing frontier models and Codex workflows to Gemini’s Model Garden, available through Google Cloud Marketplace.

拆开是三个事实：OpenAI 前沿模型进入 Gemini Model Garden；Codex 工作流一并进入；提供渠道是 Google Cloud Marketplace。注意公告页本身（openai.com/index/openai-models-google-cloud）在本站 2026-10-23 的抓取中返回 403，上述文字取自 RSS 条目字段——本站能断言的公告口径就这一句，更多的细节（哪些模型、什么价、哪些地区）官方没有放进当日可加载的渠道。

2. python 侧：标准客户端 + provider 参数

openai-python v3.36.0（release notes 的 published_at 为 2026-10-21T15:53:22Z）的 Features 第一条就是 add Vertex AI support for the Responses API（#4139）。PR 描述与 v3.37.0 tag 内附带的 vertex.md 文档给出了完整用法：

pip install 'openai[vertex]'

from openai import OpenAI
from openai.providers import vertex

client = OpenAI(provider=vertex(project="my-google-project", location="us-east5"))
response = client.responses.create(model="your-enabled-model", input="Hello", store=False)
print(response.output_text)

三个值得注意的细节，全部出自 tag 内文档与源码：

1. vertex() 的全部参数都是仅关键字参数：project、location、base_url、token_provider、credentials。project 与 location 缺省时回退读环境变量 GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_LOCATION；两者都拿不到会直接抛 OpenAIError（报错原文 Vertex requires a project ID）。
2. 示例调用带 store=False。文档没有解释为什么示例默认关闭存储；本文不推断。
3. credentials 与 token_provider 互斥：同时传入抛 OpenAIError（报错原文 Set only one of credentials and token_provider）。

3. 端点是怎么推导出来的

从 v3.37.0 tag 的 src/openai/providers/vertex.py 源码可以直接读出默认端点规则：

• location == "global" 时主机为 aiplatform.googleapis.com，否则为 {location}-aiplatform.googleapis.com；
• 完整路径为 /v1/projects/{project}/locations/{location}/publishers/openai/v1——publishers/openai 是路径里的一段字面量，其含义官方文档未解释；
• base_url= 显式指定时，它必须是 /responses 之前的完整 API 根，且不允许带凭据、查询串或片段（URL 校验不过就抛 OpenAIError）。

校验规则也写在源码里：project 允许字母、数字、下划线、点、冒号、连字符（注释说明是为兼容带点的 domain-scoped project）；location 只允许小写字母、数字与连字符。

4. node 侧：同一 API 面的另一份写法

openai-node v7.41.0（published_at 2026-10-21T15:30:50Z）以 add Vertex AI support for the Responses API（#3005） 同步落地。tag 内 docs/vertex.md 的示例：

npm install openai 'google-auth-library@>=9.15.1 <11'

import OpenAI from 'openai';
import { vertex } from 'openai/providers/vertex';

const client = new OpenAI({
  provider: vertex({ project: 'my-google-project', location: 'us-east5' }),
});

const response = await client.responses.create({
  model: 'your-enabled-model',
  input: 'Hello',
  store: false,
});

console.log(response.output_text);

node 文档补充了三句 python 文档没有明说的话：流式、工具、超时与重试都走普通 SDK 方法与选项（Streaming, tools, timeouts, and retries use the ordinary SDK methods and options）；认证用 Google 凭据、不需要 OpenAI API key（no OpenAI API key is needed）；PR #3005 还说明 Vertex 的认证助手是独立实现，与 Bedrock 的实现零依赖（This PR makes no changes to src/internal/bedrock.ts）。

5. 认证方式与安全边界

两种语言的实现把同一套边界写死在代码里：

安全边界方面，PR 描述与文档原文给出了四条：凭据只发给配置的 origin（Credentials are bound to the configured origin）；重定向被禁用（redirects are disabled）；Google API 端点强制 HTTPS（对 *.googleapis.com 域发 http 请求直接报错）；python 侧 ADC 的发现与刷新带线程锁与超时处理——异步版的 token_provider 回调运行在事件循环上、不得阻塞，读超时兜底，超时抛 APITimeoutError。

6. 官方没说的部分（本文不补）

以下问题在 2026-10-23 本站可加载的渠道里都没有答案，逐条留痕：

• 模型清单：公告只说 frontier models，未点名任何模型 ID；SDK 文档示例用占位符 your-enabled-model，并明确"模型与功能可用性取决于你的 Google Cloud deployment"。
• 定价：两包 release notes、tag 文档、RSS 描述均无定价数字。
• 地区清单：文档示例用了 us-east5，但这只是示例值，官方没有给出可用地区列表。
• Codex 工作流的形态：公告提到 Codex workflows，但 Codex 侧文档（developers.openai.com/codex 索引）当日没有出现任何 Vertex 相关页面——这句话落地成什么功能，本文不断言。
• Chat Completions 等其他 API 面：两包 PR 标题都限定 Responses API，其他 API 面是否有 vertex 支持未被提及。

7. 常见错误与排查

• 报错 Vertex requires a project ID / Vertex requires a location：没传 project / location，也没有设置对应环境变量。注意 location 校验只收小写字母、数字与连字符。
• 报错 Set only one of credentials and token_provider：两个认证参数互斥，二选一。
• 报错 Google Vertex endpoints require HTTPS：对 googleapis.com 域用了 http。改 https 即可。
• 报错 Install openai[vertex] to use Google credentials：走了 ADC 或 credentials= 但没装 extra。装 openai[vertex]（node 侧装 google-auth-library）或改用 token_provider=。
• 异步回调抛 APITimeoutError：token_provider 异步回调超过读超时才返回。把回调做成非阻塞、快返回。

8. 下一步

• 模型选型与 GPT-5.6 / GPT-6 家族的定位关系，见《GPT 模型完全指南（2026-07）：GPT-5.6 Sol / Terra / Luna 选型》；GPT-6 家族新档位的官方口径见《GPT-6 家族扩容:gpt-6-sol、gpt-6-luna、gpt-6.1-sol 进驻官方 SDK,dots 与 Intelligent UI 同窗亮相》。
• gpt-6-luna 的一个已定价用途（Decisions API 专属输入价）见《Decisions API 正式 GA：比 Responses API 快约 10 倍的低成本判定接口解读》。
• 同一周 SDK 层的其余变化（30 分钟缓存写入用量计数、compaction trigger ID、Decisions 类型破坏性变更）与 10-23 legacy 快照关停日，见《2026-10-23 legacy 快照批量关停日：17 行模型一次性下线，官方替换表与迁移清单》。