跳转到主要内容

使用条件

本页使用通用 @ai-sdk/openai-compatible 适配器,把 AI SDK 的 generateText 接到本项目的 Chat Completions。需要 Node.js 22.18+ 或 24 LTS、API Key,以及已验证支持 Chat 的模型。密钥与脚本只运行在服务端或终端。 文档目录已锁定 ai@7.0.141、@ai-sdk/openai-compatible@3.0.69,执行 npm ci 即可安装。在自己的 Node 项目中安装:
SDK 升级可能改变请求与响应归一化行为,请重新检查发送路径并运行契约测试。这个示例显式使用 provider.chatModel();不会自动改用 Responses。

完整可运行示例

保存为 examples/ai-sdk.mts,然后执行:
保留部署路径前缀,Base URL 包含 /v1,不包含 /chat/completions。下面的文本示例只接受一个完整的纯文本回答;拒绝、工具调用、截断或空文本均以非零状态结束,不把部分内容打印为成功结果。

关键设置

扩展能力逐项启用

这个脚本只验证非流式文本。流式、工具、结构化输出、视觉和向量需要单独配置及模型验证。includeUsage、supportsStructuredOutputs 等适配器选项不能让上游凭空支持对应能力;确认渠道支持后再设置。浏览器 useChat、框架路由处理器和 SDK 数据流协议也需要独立的服务端实现,不能把 API Key 直接交给浏览器。 需要原始协议细节时,查看 Chat API、流式输出、工具调用与结构化输出。 本地校验包含所有 .mts 示例的严格类型检查,以及该脚本的真实 SDK + 本机 HTTP fixture 请求检查;没有验证真实模型。参考:官方适配器文档与 generateText 参数。 Read in English