@ai-sdk/openai
Vercel AI SDK 中对接 OpenAI 服务的 provider 包,依赖 @ai-sdk/provider 和 @ai-sdk/provider-utils 完成与 OpenAI API 的对接。
核心事实
时间轴 (近 90 天)
AI SDK 内置对 OpenAI、Anthropic、Google 等多家模型提供商的适配器,开发者只需切换 provider 即可更换底层模型。
所有具体 provider 包(如 @ai-sdk/openai、@ai-sdk/anthropic、@ai-sdk/xai)都需实现 @ai-sdk/provider 声明的接口,该包的任何枚举扩展、字段增删或类型收窄都会向下游所有 provider 传导
@ai-sdk/provider-utils 承担 AI SDK 中与模型提供商交互的通用工具函数职责,包括流式响应解析、工具调用格式化、错误处理等底层逻辑
@ai-sdk/openai@3.0.121 作为补丁版本发布,核心变化是新增对 GPT-6.1 Sol 模型的支持
@ai-sdk/openai 包负责与 OpenAI 模型的对接
此次修复通过在转换层检测并展开冗余 allOf 包装,使生成的 JSON Schema 符合 OpenAI 严格模式要求
本次更新的核心修复是重写使用 allOf 包装器的递归 Zod 模式,提交记录为 4e94782
AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
文章建议升级 @ai-sdk/azure 至 4.0.82 时同步确认 @ai-sdk/openai 处于 4.0.78 或兼容版本,并在测试环境验证 Azure OpenAI 调用
@ai-sdk/amazon-bedrock 依赖 @ai-sdk/openai 不意味着需要 OpenAI 账号或密钥,因为 @ai-sdk/openai 封装了通用 HTTP 请求处理、流式响应解析、工具调用协议等底层能力供多个 provider 包共享
还有 15 条时间轴事件
全部知识事实 (20)
@ai-sdk/provider-utils 承担 AI SDK 中与模型提供商交互的通用工具函数职责,包括流式响应解析、工具调用格式化、错误处理等底层逻辑
90%已验证升级方式为运行 npm install @ai-sdk/openai@4.0.60
90%已验证AI SDK 采用 Provider 架构,每个 Provider 包实现 LanguageModelV1 等标准化接口,这是策略模式的工程实践
90%已验证AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
80%已验证@ai-sdk/openai 包负责与 OpenAI 模型的对接
75%已验证@ai-sdk/amazon-bedrock 依赖 @ai-sdk/openai 不意味着需要 OpenAI 账号或密钥,因为 @ai-sdk/openai 封装了通用 HTTP 请求处理、流式响应解析、工具调用协议等底层能力供多个 provider 包共享
75%已验证补丁版本通常向后兼容,不会带来破坏性变更
75%已验证@ai-sdk/openai@3.0.121 作为补丁版本发布,核心变化是新增对 GPT-6.1 Sol 模型的支持
90%待验证AI SDK 内置对 OpenAI、Anthropic、Google 等多家模型提供商的适配器,开发者只需切换 provider 即可更换底层模型。
50%待验证所有具体 provider 包(如 @ai-sdk/openai、@ai-sdk/anthropic、@ai-sdk/xai)都需实现 @ai-sdk/provider 声明的接口,该包的任何枚举扩展、字段增删或类型收窄都会向下游所有 provider 传导
50%待验证此次修复通过在转换层检测并展开冗余 allOf 包装,使生成的 JSON Schema 符合 OpenAI 严格模式要求
50%待验证本次更新的核心修复是重写使用 allOf 包装器的递归 Zod 模式,提交记录为 4e94782
50%待验证文章建议升级 @ai-sdk/azure 至 4.0.82 时同步确认 @ai-sdk/openai 处于 4.0.78 或兼容版本,并在测试环境验证 Azure OpenAI 调用
50%待验证对于历史消息中不受支持的努力度更新,SDK 会直接拒绝
50%待验证对历史级别采取直接拒绝而请求级别采取警告忽略的策略,兼顾运行时健壮性与数据可靠性,是一种权衡设计
50%待验证SDK 会针对模型实际支持的努力度对更新请求进行验证,对请求级别中不受支持的更新发出警告并自动忽略
50%待验证同时使用 @ai-sdk/openai 时建议将两者保持在配套版本,以避免潜在的行为不一致
50%待验证@ai-sdk/azure 复用了 @ai-sdk/openai 的大量底层逻辑,只在认证方式、端点配置、部署名称等层面做差异化处理
50%待验证当遇到Azure相关行为异常时,除查看Azure包更新日志外,还应关注其依赖的OpenAI包的变更记录
50%待验证该补丁版本新增了对 reasoningEffortUpdate: 'none' 的支持
50%