@ai-sdk/zai
Vercel AI SDK 生态中用于集成智谱(Z.ai)模型的官方 provider 包,基于 @ai-sdk/openai-compatible 兼容层构建,支持智谱 GLM 系列模型的接入
核心事实
时间轴 (近 90 天)
release note 中唯一一条变更是“Updated dependencies”。
release 页面显示这批提交累计有 5009 commits 合入 main 分支。
版本号停在补丁位,说明这次改动不涉及对外 API 的破坏性变更。
在 @ai-sdk/zai 3.0.44 中,凭证会在每个已认证请求中实时解析,而非初始化时一次性读取
@ai-sdk/zai 3.0.44 中 provider 的 API Key 与 token 配置支持 Promise 以及同步/异步回调函数
@ai-sdk/zai 3.0.44 的凭证变更保持了既有认证行为和同步凭证序列化,向后兼容
@ai-sdk/zai 3.0.44 还调整了实验性 OpenAI Live 功能中的 getServerWebSocketConfig() 方法,使其允许异步返回结果
从 3.0.43 这样较高的补丁号可以推断,该适配器处于高频小步迭代的维护模式。
@ai-sdk/zai 包发布了 2.0.16 版本,这是一次补丁级更新,核心变动是升级底层依赖,未新增功能或变更 API。
验证升级效果时,可以聚焦于流式输出的完整性和错误响应的处理路径,这两处最依赖底层工具的改动。
还有 40 条时间轴事件
全部知识事实 (20)
@ai-sdk/togetherai@3.0.51 主要变更集中在依赖项升级,未包含破坏性变更
90%已验证@ai-sdk/vue 是 Vercel AI SDK 在 Vue 生态中的适配层
90%已验证Patch 版本更新(1.0.104 → 1.0.105)意味着向后兼容的 bug 修复或依赖更新,不引入破坏性变更
90%已验证该发布记录由 GitHub Actions 自动化流程完成,并经过 GitHub 官方验证签名(Verified)
90%已验证升级 @ai-sdk/voyage 时建议同步更新 @ai-sdk/provider 与 @ai-sdk/provider-utils 以确保依赖树版本对齐
90%已验证升级方式为运行 npm install @ai-sdk/openai@4.0.60
90%已验证@ai-sdk/zai@3.0.8 未引入破坏性变更,也无新增功能
90%已验证@ai-sdk/zai 是 Vercel AI SDK 面向智谱 AI(Zhipu AI)模型的官方 Provider
90%已验证@ai-sdk/zai@3.0.8 同步更新了上游依赖:@ai-sdk/provider@4.0.12、@ai-sdk/openai-compatible@3.0.46、@ai-sdk/provider-utils@5.0.38
90%已验证该 4.0.152 版本由 GitHub Actions 自动构建并签名,提交哈希为 2deca8c。
85%已验证zai provider 依赖 @ai-sdk/openai-compatible,说明它很可能构建在 OpenAI 兼容接口之上
85%已验证@ai-sdk/zai 依赖于 @ai-sdk/openai-compatible,说明智谱 GLM 的 API 接口在很大程度上兼容 OpenAI 的调用规范
85%已验证@ai-sdk/openai-compatible 的核心职责包括:将 AI SDK 的统一调用参数转换为 OpenAI 格式、解析响应并映射回 AI SDK 的标准化结果、处理流式响应的分块与错误。
80%已验证AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
80%已验证本次更新将依赖 ai 升级到 7.0.102,将 @ai-sdk/provider-utils 升级到 5.0.41
80%已验证@ai-sdk/zai模块依赖于provider、openai-compatible和provider-utils等基础模块
80%已验证可通过npm install @ai-sdk/zai@1.0.3或yarn add @ai-sdk/zai@1.0.3命令进行升级
80%已验证在依赖链中,补丁版本仍可能通过升级间接依赖引入行为变化,因此建议即使面对补丁更新也应运行测试套件。
75%已验证Z.ai 选择通过 openai-compatible 接入是一种效率优先的策略,代价是当 Z.ai 有超出 OpenAI 规范之外的独有能力时,兼容层可能需要额外适配代码。
75%已验证@ai-sdk/zai 作为 Z.ai 的 Provider 实现,底层复用了 OpenAI 兼容层的通信与协议处理逻辑
75%