OpenAI维护的官方JavaScript与TypeScript库openai-node于上海时间2026年9月18日发布v7.18.0。本次发布通过GitHub Release归一验证,接口显示published_at为2026-09-18T00:38:35Z,对应北京时间2026年9月18日08时38分,落在当日00:00至23:59窗口内。仓库地址为https://github.com/openai/openai-node,归属OpenAI组织,项目定位为OpenAI API的官方Node.js封装,许可证为Apache-2.0,保持不变。发布页标题标注7.18.0(2026-09-17)为变更生成日期,实际首次公开以published_at为准,对比区间为v7.17.0至v7.18.0,中国开发者可通过npm包openai升级验证,不改变服务端模型可用范围与计费规则。

关键变化

  • - 功能:新增智能体会话模型设置(#2755),更新会话时可指定模型、推理力度与服务层级,便于按会话覆盖默认配置 - 功能:新增音频迷你模型选项(#2759),在共享与Responses类型中暴露gpt-audio-mini系列,保持既有选项兼容 - 功能:新增托管Responses WebSocket会话(#2760),支持自定义请求头、独立通道与最终响应收集,明确重连需应用层恢复且不自动重放 - 功能:新增提示缓存预热开关(#2761),在Responses提示缓存类型中暴露prewarm布尔选项,缺省与显式false行为不变 - 修复与文档:校验WebSocket结果并保留头默认值(#2763),澄清呼入SIP呼叫标识用法(#2758),更新图像请求示例(#2762)

适用对象与价值

面向已使用或计划通过Node.js对接OpenAI Responses、实时会话与流式工具调用的开发者与团队,特别是需要按会话动态调整模型与推理参数、接入音频迷你模型、维护长连接WebSocket通道与优化提示缓存命中的场景。智能体会话设置有助于在同一应用内为不同任务配置不同模型与推理力度,减少重复创建客户端的样板代码。托管WebSocket会话有助于统一管理握手头、并发通道与响应收集,降低自建连接池的维护成本。缓存预热选项有助于在高频相同前缀请求的业务中提前准备缓存,音频迷你选项有助于在语音与多模态链路中直接使用类型定义。对中国用户的直接价值在于客户端类型更完整,升级后无需改变提示词即可获得更可预期的会话与长连接行为。

兼容性与安装条件

本次为常规版本更新,发布说明未声明破坏性接口变更与许可证变更,对比区间为小功能与修复集合,可按常规小版本评估升级。安装沿用npm体系,仓库为https://github.com/openai/openai-node,npm包名为openai,可执行npm install openai@7.18.0或将package.json固定至该版本后安装,需按仓库说明配置OPENAI_API_KEY或工作负载身份后调用。实际模型可用范围、区域、配额与价格以后端服务与账户权限为准,SDK仅完成客户端类型与协议封装,不改变服务端策略。升级前建议核对TypeScript类型变更对自有会话更新逻辑、WebSocket封装与缓存配置的影响。

限制与注意事项

发布说明未提供基准性能、成功率或成本对比数据,不应将其理解为性能提升承诺。WebSocket长连接与缓存预热效果仍受服务端、网络与账户限流影响,类型补齐不等同于服务端已对当前账户开放对应模型。托管会话明确不自动重放请求,重连后的应用状态恢复需业务层自行实现,历史依赖自动重试的写法需调整。呼入SIP标识与图像示例为文档与示例更新,不改变鉴权与计费逻辑。建议先在预发环境回归会话更新、音频模型调用、WebSocket建连断连重连、提示缓存读写与图像生成链路,再全量升级。本文不对安全性、长期维护与后续版本兼容作超出发布说明的保证。

下一步

已使用该SDK的项目可将版本固定至v7.18.0,在预发环境验证智能体会话参数覆盖、音频迷你模型类型引用、托管WebSocket会话的头透传与通道隔离、缓存预热开关行为及现有流式与工具调用回归后发布。未接入的团队可按仓库说明完成初始化、鉴权与代理配置。更多细节见Release v7.18.0说明、对比v7.17.0至v7.18.0与提交记录,以及GitHub API中的published_at字段对应北京时间2026年9月18日的归一验证。