@ai-sdk/openai-compatible
Vercel AI SDK 生态中针对兼容 OpenAI API 规范的第三方服务的适配包，允许将任何遵循 OpenAI Chat Completions 协议的服务接入 AI SDK
核心事实
xAI 提供与 OpenAI 兼容的 API 接口，这是早期 @ai-sdk/xai 能通过 Chat Completions 端点进行适配的基础
升级 @ai-sdk/voyage 时建议同步更新 @ai-sdk/provider 与 @ai-sdk/provider-utils 以确保依赖树版本对齐
@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 天)
兼容层（如 openai-compatible）无法覆盖供应商特有的扩展字段，需要额外适配。
3.0.148 是一次 Patch 更新，改动仅在于将 @ai-sdk/openai-compatible 依赖更新到 2.0.89。
使用者应建立依赖版本的可观测性，例如在 CI 中锁定关键基础包的版本，并在升级时对照发布说明中的依赖清单逐项核对。
实际接入智谱模型时，建议先用小流量验证关键能力，因为 openai-compatible 适配层可能无法完全表达厂商私有参数、特殊的多模态输入格式或独有的工具调用细节。
由于 xai 包同时依赖 provider-utils 和 openai-compatible 两条依赖线，一次依赖更新实际上是在同步两条链路上的修正。
文章建议开发者在 package.json 中为 @ai-sdk/vue 和 ai 设置一致的版本范围。
openai-compatible 是一类「协议适配器基座」，让任何遵循 OpenAI Chat Completions 接口风格的厂商（Z.ai、DeepSeek、Together 等）都能以极少代码接入。
建议升级时优先检查 package.json 中两个被更新依赖的解析版本是否一致，避免因锁文件导致的版本分裂。
基于 openai-compatible 层接入模型可复用请求构造、流式解析和工具调用处理逻辑，降低维护成本，但行为会受该兼容层实现细节影响。
三个包之间存在严格的依赖链：适配器依赖 openai-compatible，openai-compatible 又依赖 provider 与 provider-utils。
还有 40 条时间轴事件
全部知识事实 (20)
xAI 提供与 OpenAI 兼容的 API 接口，这是早期 @ai-sdk/xai 能通过 Chat Completions 端点进行适配的基础
90%已验证升级 @ai-sdk/voyage 时建议同步更新 @ai-sdk/provider 与 @ai-sdk/provider-utils 以确保依赖树版本对齐
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%已验证@ai-sdk/togetherai 是 Vercel AI SDK 官方提供的 TogetherAI 平台适配器，构建在 openai-compatible 基础包之上
90%已验证Vercel AI SDK 提供统一的抽象接口（如 generateText、streamText），使开发者调用不同模型供应商时代码风格保持一致
90%已验证OpenAI API的接口规范已成为AI行业事实上的通信标准，包括Anthropic、Google、Mistral在内的众多模型提供商都提供兼容该格式的接口
90%已验证@ai-sdk/openai-compatible 是许多 OpenAI 兼容模型服务的公共兼容层，其版本变动可能同时影响多个提供商适配包。
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%已验证升级类似补丁依赖时，建议在 lockfile 中确认依赖解析结果，并关注 @ai-sdk/openai-compatible 2.0.86 的变更日志。
75%已验证AI SDK 多包协同生态中，若底层包（如 provider-utils 或 openai-compatible）发生 MAJOR 变更，依赖它的所有供应商适配包都会被迫跟进，形成连锁升级。
75%已验证Z.ai 选择通过 openai-compatible 接入是一种效率优先的策略，代价是当 Z.ai 有超出 OpenAI 规范之外的独有能力时，兼容层可能需要额外适配代码。
75%已验证@ai-sdk/zai 作为 Z.ai 的 Provider 实现，底层复用了 OpenAI 兼容层的通信与协议处理逻辑
75%已验证@ai-sdk/openai 包负责与 OpenAI 模型的对接
75%已验证@ai-sdk/amazon-bedrock 依赖 @ai-sdk/openai 不意味着需要 OpenAI 账号或密钥，因为 @ai-sdk/openai 封装了通用 HTTP 请求处理、流式响应解析、工具调用协议等底层能力供多个 provider 包共享
75%已验证@ai-sdk/zai 构建在 @ai-sdk/openai-compatible 兼容层之上，只需配置智谱特有的端点地址与参数
75%