OpenAI SDK 一日四版:safety_identifier 进入图像接口,Realtime Translation 会话落地(v3.33/v3.34 + v7.36/v7.37)
2026-10-17 当天,openai-python 连发 v3.33.0 与 v3.34.0,openai-node 连发 v7.36.0 与 v7.37.0:safety_identifier 参数进入图像请求与响应两侧,Realtime Translation WebSocket 会话上线,两包同步新增 degraded external storage 状态,node 侧并为 GPT-4 模型别名加了 shutdown 通告。
openai-python 3.32.0 与 openai-node 7.35.0 更新解读:prompt 建声、Live 音频夹具与 Live Decisions覆盖 v3.32.0/v7.35.0 才过去一天,OpenAI 的双包发布列车又跑出四站:2026-10-17 当天,openai-python 连发 v3.33.0 与 v3.34.0,openai-node 连发 v7.36.0 与 v7.37.0。四份 release notes 合起来是一次以安全标识符与实时翻译为主的 API 面扩张,本文所有参数级事实都出自当日可抓取的 SDK 源码 diff 与 release notes 原文。
safety_identifier:图像接口拿到统一的安全标识参数
v3.33.0(python)与 v7.36.0(node)的同一 feature 是 add safety identifiers to image requests and responses(python #4093、node #2957)。参数本身可以直接在 v3.33.0 的源码 diff 里逐字读出:safety_identifier 为 string 或 null,maxLength 128,示例值 user-1234。官方描述原文是「A stable identifier for an end user in your organization, used for safety monitoring and abuse detection」——组织内终端用户的稳定标识,用于安全监测与滥用检测;建议对用户名或邮箱先做哈希,避免向 API 发送明文身份信息。
行为规则也写在源码里:非空的 safety_identifier 优先于 user 参数;user 已被标记 deprecated,仅在 safety_identifier 缺省、null 或空字符串时继续被接受。这条迁移路径与 SDK 文档指引一致——官方文档站的 safety best practices 页面(2026-10-18 直达 200)也给出了 implement safety identifiers 的章节锚点。
值得强调的是范围:release notes 明确写的是 image requests and responses——即同一标识符既随请求传入、也出现在响应对象上,两侧对称。至于其他接口面是否已有同款参数,两份 notes 都没说,本文不做超出措辞的推断。
Realtime Translation:python 落新会话,node 换生成绑定
v3.34.0 的第二个 feature 是 add Realtime Translation WebSocket sessions(#4095)——Realtime 家族再添一个 WebSocket 会话类型。node 侧的对应动作出现在 v7.37.0 的 Refactors 一节:realtime 改用生成的 Translation 绑定(#2961)。两份说明都没有给出字段表或端点名,从两包的动作组合看,这是同一 API 面以「python 手写 + node 代码生成」的常规节奏对齐;超出该措辞的行为细节本文不断言。
两包同步与两个次级变化
degraded external storage status 以 feature 名义同日出现在两包(python #4097、node #2963)。release notes 对它的描述只有这一行——从命名看是某处状态枚举的新取值,但具体挂载点与触发条件官方未写,本文不背书任何推断。
两个次级变化值得记录:其一,node v7.37.0 的 Chores 为 GPT-4 模型别名添加 shutdown 通告(#2959)——SDK 侧开始为 GPT-4 别名提示下线,这与官方 2026-10-14 弃用潮公告同向(OpenAI 2026 年 10 月弃用潮:GPT-4o 与 GPT-4.1 家族 2027-01-14 关停、TTS 四件套转投 gpt-realtime-2.1-mini已覆盖公告本体);SDK 通告未携带新日期,下线时间以官方公告为准。其二,python v3.33.0 将 Decisions cache breakpoint 的参数类型改为共享(#4092)——类型层的重构,使该参数类型可被多处复用,无行为变更声明。
版本对照表
| 变更 | openai-python | openai-node | 说明层级 |
|---|---|---|---|
| safety identifiers 进图像请求与响应 | v3.33.0(#4093) | v7.36.0(#2957) | 参数级(源码 diff 可核) |
| Realtime Translation WebSocket sessions | v3.34.0(#4095) | v7.37.0(#2961,重构为生成绑定) | release notes 一句话 |
| degraded external storage status | v3.34.0(#4097) | v7.37.0(#2963) | release notes 一句话 |
| GPT-4 别名 shutdown 通告 | — | v7.37.0(#2959,Chores) | chores 级 |
| Decisions cache breakpoint 类型共享 | v3.33.0(#4092) | — | 类型重构 |
四个版本的发布时间均以 GitHub releases 的 published_at(2026-10-17)为准;python v3.33.0 的 semver 比较头标注 2026-10-16,与 published_at 相差一天,本文统一引用 API 字段。
下一步
- 已在用
user参数做安全归因的调用方:迁到safety_identifier,传哈希后的标识符,注意 128 字符上限。 - 在用 Realtime 的团队:关注 Translation 会话在两包的类型对齐节奏,node 侧等生成绑定稳定后再切。
- 关注弃用时间线的:以 OpenAI 2026 年 10 月弃用潮:GPT-4o 与 GPT-4.1 家族 2027-01-14 关停、TTS 四件套转投 gpt-realtime-2.1-mini为时间锚,SDK 通告只是提示层。
关键要点
- 四个版本全部发布于 2026-10-17(GitHub releases 的 published_at):openai-python v3.33.0 与 v3.34.0、openai-node v7.36.0 与 v7.37.0——距上一对 v3.32.0/v7.35.0(2026-10-16)不到一天
- safety_identifier 参数级事实(出自 v3.33.0 提交 c969e32 的 SDK 源码 diff):string 或 null、maxLength 128、示例 user-1234;官方描述为「组织内终端用户的稳定标识符,用于安全监测与滥用检测」,建议对用户名/邮箱做哈希以免发送身份信息;非空值优先于已标记 deprecated 的 user 参数(user 仅在 safety_identifier 缺省、null 或空时继续被接受)
- 同一 safety_identifier 变更落在图像请求与响应两侧(release notes 原文 add safety identifiers to image requests and responses;python #4093、node #2957)
- Realtime Translation WebSocket sessions 在 python v3.34.0 落地(#4095);node v7.37.0 同期把 realtime 重构为生成的 Translation 绑定(#2961,Refactors)——两包对同一 API 面的两种呈现节奏
- degraded external storage status 由两包同日各自新增(python #4097、node #2963);release notes 对它的描述只有这一句,本文不推断其语义细节
- node v7.37.0 的 Chores 一节为 GPT-4 模型别名添加 shutdown 通告(#2959),与 2026-10-14 官方弃用潮公告同向;python v3.33.0 另将 Decisions cache breakpoint 参数类型改为共享(#4092)
常见问题
官方参考
相关文章
openai-python 3.32.0 与 openai-node 7.35.0 更新解读:prompt 建声、Live 音频夹具与 Live Decisions
2026-10-16 两包官方 SDK 同日再发:语音可以用一段文字描述直接创建(但只在 Live 可用)、Live 会话能播 30 秒内的音频夹具、Decisions 问题评估接进 Live 转写触发器,Decisions API 也拿到了 prompt caching。本文只写两包 CHANGELOG 与 tag 源码里能指出的东西。
阅读全文OpenAI SDK 新增 Browser/Computer 工具集(1/4):BrowserToolset 把驱动方法变成 Responses 函数工具
2026-10-14 两包官方 SDK 同日四发:openai-python 3.30.0/3.31.0 与 openai-node 7.33.0/7.34.0。头条是标注 (1/4) 的 browser and computer toolsets——BrowserToolset 不给 Responses API 加原生浏览器工具类型,而是把你自带驱动的结构化方法变成普通函数工具。本文只写两包 CHANGELOG 与 v3.31.0 tag 源码/文档里能指出的东西。
阅读全文OpenAI SDK 出现托管 Agent 环境资源:prewarmed 预热创建、闲置挂起与过期事件
2026-10-09 至 10-11 三天,openai-python 连发 v3.27.0/v3.28.0/v3.29.0、openai-node 发 v7.32.0,同一条 agent environment API 线浮出水面:预热创建、挂起与过期。本文只写 SDK 源码与当日 GitHub release notes 里能指出的东西。
阅读全文订阅 GPTMap Weekly
每周一封邮件,精选 OpenAI 重要更新、深度解读与最佳实践。无广告,可随时退订。
提交后将在新标签页打开 Buttondown 完成订阅确认。