OpenAI Python SDK发布 3.14.0：流式读取错误统一化，多项缺陷修复
OpenAI Python SDK于 2026 年 9 月 14 日发布v3.14.0，新增流式读取错误的规范化处理，并修复向量存储文件轮询、错误码类型、日志级别等八项问题。
AI解读：OpenAI Python SDK的v3.14.0在 9 月 14 日发布，属于一次维护性更新：只增加了一项行为变更，其余都是修复和文档调整。这项变更针对流式读取过程中抛出的错误做统一处理，开发者捕获异常时不再需要针对不同读取阶段写多套判断。
对使用SDK的人更实际的影响在细节：向量存储文件轮询被加上边界，长时间等待上传完成的任务不容易无限挂住；API错误码统一成字符串，类型检查更稳定；标准OPENAI_LOG级别获得支持，日志配置可以和常见日志环境对齐。这些都是小修补，但直接减少调试时的困惑。
更新还处理了几类边缘情况：文件上传路径为PathLike时的元组归一化、内容过滤错误中携带补全内容、空条目后保留响应流索引、输出文本中的null处理，以及实时语音示例的会话类型刷新。判断是否需要立即升级，取决于你是否用到了这些路径。
OpenAI Python SDK发布v3.14.0，版本号对比v3.13.0，发布日期为 2026 年 9 月 14 日。
据OpenAI Python SDK的发布说明，该版本包含一项功能变更和八项缺陷修复，另有一项文档更新。
流式读取错误被统一规范
该版本唯一的功能变更位于streaming模块：规范化读取流时抛出的错误（normalize errors raised while reading streams，对应 #3827 号issue）。
这意味着开发者在读取流式响应过程中遇到的异常，会被SDK统一处理，而不是以不同形态暴露给调用方。
八项缺陷修复涵盖轮询、错误码与日志
发布说明列出了以下缺陷修复，每一项都标注了对应的issue或提交编号：
日志方面，支持标准的OPENAI_LOG级别（#3734）。
文件相关，规范化PathLike形式的上传元组（#3475）。
错误处理方面，在内容过滤错误中包含补全内容（#3094），并将API错误码规范化为字符串（#3532，关联 #3531）。
流式响应方面，在空条目之后保留响应流索引（#3126）。
响应处理方面，处理output_text中的null文本（#3019）。
向量存储方面，对向量存储文件轮询设置边界（bound vector store file polling，对应 #3401）。
示例方面，刷新了实时推送对讲应用的会话类型（realtime push_to_talk_app，对应 #2926）。
- 日志：支持标准OPENAI_LOG级别（#3734）
- 文件：规范化PathLike上传元组（#3475）
- 错误：内容过滤错误包含补全内容（#3094）；API错误码规范化为字符串（#3532，关联 #3531）
- 流式：空条目后保留响应流索引（#3126）
- 响应：处理output_text中的null文本（#3019）
- 向量存储：限制文件轮询边界（#3401）
- 示例：刷新实时推送对讲应用会话类型（#2926）
文档更新
文档方面，README示例改用了视觉指南中的图片（#3849）。