[控场AI]
产品ai-sdk/zai / zai provider

@ai-sdk/zai

Vercel AI SDK 生态中用于集成智谱(Z.ai)模型的官方 provider 包,基于 @ai-sdk/openai-compatible 兼容层构建,支持智谱 GLM 系列模型的接入

核心事实

时间轴 (近 90 天)

10月30日

release note 中唯一一条变更是“Updated dependencies”。

待验证50%
10月30日

release 页面显示这批提交累计有 5009 commits 合入 main 分支。

待验证50%
10月30日

版本号停在补丁位,说明这次改动不涉及对外 API 的破坏性变更。

待验证50%
10月30日

在 @ai-sdk/zai 3.0.44 中,凭证会在每个已认证请求中实时解析,而非初始化时一次性读取

待验证50%
10月30日

@ai-sdk/zai 3.0.44 中 provider 的 API Key 与 token 配置支持 Promise 以及同步/异步回调函数

待验证70%
10月30日

@ai-sdk/zai 3.0.44 的凭证变更保持了既有认证行为和同步凭证序列化,向后兼容

待验证50%
10月30日

@ai-sdk/zai 3.0.44 还调整了实验性 OpenAI Live 功能中的 getServerWebSocketConfig() 方法,使其允许异步返回结果

部分验证85%
10月29日

从 3.0.43 这样较高的补丁号可以推断,该适配器处于高频小步迭代的维护模式。

待验证50%
10月29日

@ai-sdk/zai 包发布了 2.0.16 版本,这是一次补丁级更新,核心变动是升级底层依赖,未新增功能或变更 API。

待验证50%
10月29日

验证升级效果时,可以聚焦于流式输出的完整性和错误响应的处理路径,这两处最依赖底层工具的改动。

待验证50%

还有 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%

来源文章