开源OpenAI Python SDK Releases·原文 2026年9月24日

openai-python发布v3.19.2:修复回退提取路径丢失单文件问题

OpenAI Python SDK在 2026 年 9 月 23 日发布 3.19.2 补丁版本,修复一个回退提取路径下文件保留的bug,并同步澄清Web搜索位置默认值、Realtime模态数组定义等API文档措辞。

AI解读:这个补丁版本只改了一个功能性bug:在fallback extraction路径下,单个文件之前可能被丢掉或合并不当,现在会被保留下来。对依赖SDK处理文件提取、尤其是走回退逻辑的用户,这是实际影响行为的一行修复。

其余三条都是文档/规格措辞性质的改动:澄清近似Web搜索位置的默认值、澄清Realtime模态数组的定义、修正微调参数边界和Realtime响应引用。它们不改变运行时行为,但会让按文档写代码的人少踩坑。

如果你不用回退提取路径,这次升级优先级不高;如果项目里恰好依赖单文件保留语义,值得对一下 3.19.1 与 3.19.2 的行为差异。来源是发布说明摘要,没有附带测试细节或受影响场景的完整列表。

OpenAI的官方Python SDK仓库openai-python发布了 3.19.2 版本,发布日期为 2026 年 9 月 23 日。该版本由openai-sdks[bot] 发布,属于 3.19.1 之后的补丁更新。

发布说明列出的唯一Bug Fix是“preserve single files for fallback extraction paths”,对应issue #3875,提交哈希为bfd3680。

除此之外还有三项归在Chores下的改动,均为API层面的说明性调整:澄清approximate web search location的默认值(#3953)、澄清Realtime modality数组定义(#3954)、修正fine-tuning边界与Realtime响应引用(#3949)。

修复内容:回退提取路径不再丢失单个文件

发布说明将 3.19.2 唯一的功能性修复描述为:在fallback extraction paths中保留单个文件(preserve single files for fallback extraction paths)。该修复关联issue #3875,对应提交bfd3680。

发布说明没有进一步说明“fallback extraction paths”具体覆盖哪些代码路径,也没有给出复现步骤或受影响的调用场景;来源仅为发布说明摘要,未包含测试用例或完整上下文。

  • 版本:3.19.2(对比v3.19.1)
  • 日期:2026-09-23
  • 类型:Bug Fix
  • 关联issue:#3875
  • 提交:bfd3680

三项Chores:默认值、模态数组与微调边界说明修正

发布说明把剩余三项改动归入Chores,均标注为api范围:其一澄清approximate web search location的默认值(#3953,提交a95c95e);其二澄清Realtime modality数组定义(#3954,提交e79cf53);其三修正fine-tuning边界以及Realtime response reference(#3949,提交 325a948)。

按发布说明的归类,这三项属于文档或规格措辞的澄清与修正,发布说明未将其列在Bug Fixes之下,也未说明它们会改变SDK的运行时行为。

  • #3953:澄清approximate web search location默认值
  • #3954:澄清Realtime modality数组定义
  • #3949:修正fine-tuning bounds与Realtime response reference

信息来源