TypeSafe JavaScript SDK 0.7.0
一次面向 Node.js 22 的破坏性 SDK 更新，加入实验性图片与 Box 支持、zstd 请求压缩和请求处理修复。
- 发布日期
- 2026-10-14
- 核实日期
- 2026-10-19
- 产品
- TypeSafe JavaScript SDK
安装方式
npm install @typesafe-ai/sdk@0.7.0发布背景
本页根据 TypeSafe JavaScript SDK 0.7.0 官方发布记录整理，用于说明评估和迁移时的版本边界，不包含实时 API 集成，也不把实验性能力描述为长期不变的契约。
更新重点
- 实验性图片请求需要设置 TypeSafe-Danger-Zone-Images: true 请求头。
- Box 回答可通过 jev-preview 使用，仍属于实验性图片工作流的一部分。
- 修复内容覆盖空 token 数量、更多请求校验、无效请求返回 rejected promise、运行时 score criteria，以及请求超时或中止时的 unhandled rejection。
安装方式
npm install @typesafe-ai/sdk@0.7.0
pnpm add @typesafe-ai/sdk@0.7.0兼容与升级检查
- 该破坏性版本要求 Node.js 22+，并停止导出请求 payload 类型；升级前需要调整运行环境和类型导入。
- 在 Node.js 22.15+ 中，大于等于 1 KiB 的请求会使用 zstd 压缩；目标服务不支持时可设置 compression: false。
- 图片与 Box 仍属实验性能力，Box 使用 jev-preview；只有在复现本次版本时才应固定 0.7.0。
范围说明
本页不承诺 zstd 会带来性能提升。实际结果取决于请求大小、运行环境和服务端支持，实验性图片与 Box 请求格式也可能变化。