OpenAI SDK v3.35.1 发布：修复 WebSocket 字节读取问题

据 GitHub 上 openai-sdks 仓库的发布记录，OpenAI SDK 于 2026 年 10 月 18 日发布了 v3.35.1 版本。这是一个以缺陷修复为核心的小版本更新，主要解决 beta Realtime 功能在 websockets 13 环境下的字节读取问题。

版本更新概览

v3.35.1 是一个补丁版本，没有引入新功能，也没有破坏性变更。发布说明中列出的唯一一项变更是 Bug Fixes 类别下的条目：在 websockets 13 上保留 beta Realtime 的字节读取行为（preserve beta Realtime byte reads on websockets 13），对应 PR #4102，提交哈希为 5766349。

该提交由 GitHub 验证签名创建，GPG 密钥 ID 为 B5690EEEBB952194。发布产物包含 2 个资源文件，标志着这是一个标准的库版本发布流程。

补丁版本（patch release，语义化版本中的第三位）通常只包含向后兼容的缺陷修复，不引入新功能，也不改变公开接口，因此升级风险较低。发布说明中的 PR 编号和提交哈希是追溯变更来源的关键线索：PR #4102 对应具体的代码改动，提交哈希 5766349 则可用于在仓库历史中精确定位该提交。GitHub 验证签名表示该提交由持有对应 GPG 私钥的维护者创建，可用于确认代码来源的真实性，防范供应链篡改。发布产物中的资源文件一般包括源码包与构建分发包，是包管理器拉取安装内容的直接来源。

问题背景：beta Realtime 与 websockets 13

Realtime API 是 OpenAI 面向实时交互场景提供的接口，SDK 中的 beta 模块对其提供封装支持。WebSocket 是 Realtime 通信的底层传输方式之一，而 Python 生态中的 websockets 库在 13 版本对部分行为做了调整。

当底层 websockets 升级到 13 后，SDK 在处理字节类型消息时可能出现读取方式不一致的情况。PR #4102 的修复目标是让 beta Realtime 在 websockets 13 上继续以字节形式读取消息，避免因版本差异导致的数据解析异常。对于依赖 Realtime 做语音或流式交互的开发者而言，这类兼容性修复直接影响连接稳定性。

Realtime API 并非传统的请求-响应式接口，而是基于长连接的双向流式通道，用于语音对话、实时转写等低延迟场景。其底层通常通过 WebSocket 协议承载，消息可以以文本帧或二进制帧的形式传输。所谓“字节读取”，指 SDK 从 WebSocket 连接中接收二进制帧时，选择以 bytes 而非 str 的形式将其交还给上层逻辑。这一差异看似细微，却直接影响消息的解析方式：若按文本处理，二进制音频或事件负载可能被错误解码或截断。websockets 13 对帧类型与消息重组行为做了调整，因此 SDK 需要显式保留字节读取路径，才能保证 Realtime 数据按预期流转。

websockets 是 Python 生态中最主流的 WebSocket 客户端与服务端实现，被大量异步框架和 SDK 作为底层传输依赖。该库在 13 版本中收紧了部分 API 行为，例如对消息类型和接收接口的返回形式做了更严格的区分，这使得依赖旧有默认行为的封装层需要显式适配。对于 SDK 这类中间层而言，底层库的小版本升级往往不会触发编译期错误，却可能在运行时改变数据类型，因此兼容性修复通常以显式指定读取模式的方式落地。

开发者升级建议

由于这是补丁级更新，升级成本较低。使用 beta Realtime 功能且运行在 websockets 13 上的项目应优先升级到 v3.35.1；如果项目固定在较旧的 websockets 版本，且未启用 Realtime，则本次更新对现有行为的影响有限，可按常规节奏跟进。

升级前建议在测试环境中验证 Realtime 连接的消息收发，确认字节读取路径正常，再推送到生产环境。同时留意 SDK 版本与 websockets 版本的组合矩阵，避免同时升级多个底层依赖而掩盖问题来源。

小结

v3.35.1 是一次范围明确的小修复：在不改变公开接口的前提下，解决了 beta Realtime 在 websockets 13 上的字节读取兼容问题。对于实时通信相关的集成，这类补丁值得及时跟进。