GPTMap

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 通告。

TL;DR
2026-10-17 一天内 openai-python 发布 v3.33.0 与 v3.34.0、openai-node 发布 v7.36.0 与 v7.37.0。核心变化四件:safety_identifier(字符串、上限 128 字符,组织内终端用户的稳定标识,用于安全监测与滥用检测,官方建议对用户名或邮箱先做哈希)进入图像请求与响应两侧;Realtime Translation WebSocket 会话在 python 侧落地(node 侧同期改用生成的 Translation 绑定);两包同步新增 degraded external storage 状态;node v7.37.0 的 chores 为 GPT-4 模型别名加 shutdown 通告,与 10-14 弃用潮同向。
safety_identifier 是 OpenAI 图像 API 在 2026-10-17 的 SDK 版本(openai-python v3.33.0、openai-node v7.36.0)中新增的请求与响应参数:一个不超过 128 字符的字符串,作为组织内终端用户的稳定标识,供安全监测与滥用检测使用;官方建议存入哈希后的用户名或邮箱而不是明文,且非空值优先于已废弃的 user 参数。

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-pythonopenai-node说明层级
safety identifiers 进图像请求与响应v3.33.0(#4093)v7.36.0(#2957)参数级(源码 diff 可核)
Realtime Translation WebSocket sessionsv3.34.0(#4095)v7.37.0(#2961,重构为生成绑定)release notes 一句话
degraded external storage statusv3.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 字段。

下一步

关键要点

  • 四个版本全部发布于 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)

常见问题

按 SDK 源码描述:一个稳定的终端用户标识符,用于安全监测与滥用检测,长度上限 128 字符。官方建议先对用户名或邮箱做哈希再传入,避免发送明文身份信息。行为规则:非空 safety_identifier 优先;它为空或缺省时,API 退回读取已废弃的 user 参数。

官方参考

相关文章

订阅 GPTMap Weekly

每周一封邮件,精选 OpenAI 重要更新、深度解读与最佳实践。无广告,可随时退订。

提交后将在新标签页打开 Buttondown 完成订阅确认。

GPTMap Editorial发布于 2026-10-18 6 分钟阅读