@ai-sdk/openai-compatible
Vercel AI SDK 生态中针对兼容 OpenAI API 规范的第三方服务的适配包，允许将任何遵循 OpenAI Chat Completions 协议的服务接入 AI SDK
核心事实
xAI 提供与 OpenAI 兼容的 API 接口，这是早期 @ai-sdk/xai 能通过 Chat Completions 端点进行适配的基础
@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
@ai-sdk/togetherai 是 Vercel AI SDK 官方提供的 TogetherAI 平台适配器，构建在 openai-compatible 基础包之上
时间轴 (近 90 天)
基于 openai-compatible 层接入模型可复用请求构造、流式解析和工具调用处理逻辑，降低维护成本，但行为会受该兼容层实现细节影响。
三个包之间存在严格的依赖链：适配器依赖 openai-compatible，openai-compatible 又依赖 provider 与 provider-utils。
当 @ai-sdk/openai-compatible 对协议细节（如 tool call 增量拼接、usage 字段）做调整时，下游适配器会随依赖升级被动继承这些变化。
兼容层的一次修复会同时惠及所有下游提供商，但兼容层的细微行为变化也会横向传导，因此依赖升级时应查看其 changelog 确认改动内容。
兼容层的任何行为变化（如字段映射、流式响应处理、错误码转换）都会通过依赖更新传导到所有下游 provider。
在锁定版本时，应同时关注 provider 包与兼容包两者的版本组合，而不是只盯住顶层包号。
由于不同厂商可能在字段默认值、错误码、流式终止条件上存在细微差异，兼容包需要持续微调以覆盖这些边缘情况，这也是其频繁发布 patch 的原因之一。
@ai-sdk/openai-compatible 的核心职责包括：将 AI SDK 的统一调用参数转换为 OpenAI 格式、解析响应并映射回 AI SDK 的标准化结果、处理流式响应的分块与错误。
升级类似补丁依赖时，建议在 lockfile 中确认依赖解析结果，并关注 @ai-sdk/openai-compatible 2.0.86 的变更日志。
@ai-sdk/openai-compatible 是许多 OpenAI 兼容模型服务的公共兼容层，其版本变动可能同时影响多个提供商适配包。
还有 36 条时间轴事件
全部知识事实 (20)
xAI 提供与 OpenAI 兼容的 API 接口，这是早期 @ai-sdk/xai 能通过 Chat Completions 端点进行适配的基础
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-sdk/zai模块依赖于provider、openai-compatible和provider-utils等基础模块
80%已验证AI SDK 多包协同生态中，若底层包（如 provider-utils 或 openai-compatible）发生 MAJOR 变更，依赖它的所有供应商适配包都会被迫跟进，形成连锁升级。
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%已验证@ai-sdk/openai-compatible 处理流式输出、工具调用、错误格式归一化等通用逻辑
75%已验证@ai-sdk/zai 发布了 3.0.32 版本，是一次仅含两个 commit 的补丁更新（Patch Changes）
80%待验证基于 openai-compatible 层接入模型可复用请求构造、流式解析和工具调用处理逻辑，降低维护成本，但行为会受该兼容层实现细节影响。
50%待验证三个包之间存在严格的依赖链：适配器依赖 openai-compatible，openai-compatible 又依赖 provider 与 provider-utils。
50%