TS 工具包:统一的 generateText / streamText、工具调用、结构化输出(Zod)、React 的 useChat 等 hooks。其 @ai-sdk/openai-compatible 的 createOpenAICompatible({name, apiKey, baseURL}) 就是专为自定义兼容接口设计的。
适用场景:给网站/产品加聊天、流式问答、生成式 UI 的前端/全栈开发者。
typescript nextjs vercel-ai-sdk streaming react
操作步骤
- npm install ai @ai-sdk/openai-compatible。
- 服务端建 provider:
createOpenAICompatible({name: "my-api", apiKey: process.env.{{API_KEY}}, baseURL: "https://tokenbuddy.cc/v1"})。 - 用
streamText({model: provider("your-model-id"), prompt: ...})做流式,Key 只放服务端环境变量。
代码示例
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";
const provider = createOpenAICompatible({ name: "my-api", apiKey: process.env.{{API_KEY}}, baseURL: "https://tokenbuddy.cc/v1" });
const { text } = await generateText({ model: provider("your-model-id"), prompt: "Write a haiku about APIs." });
console.log(text);开源项目信息
- 仓库:https://github.com/vercel/ai
- Stars 口径:本次检索未给出可引用星数,不填报
- 许可:本次检索未明示,以仓库 LICENSE 为准
接入本站 API:模型 ID 用本站列表里的原样字符串;该 SDK 官方技能页特别警告:版本变化极快、
useChat 等 API 常改名,不要凭记忆写代码,要对着所装版本的文档写。注意事项
- ⚠️ 把 Key 写进前端组件 = 直接泄露和盗刷,Key 只能在服务端
- ⚠️ 迁移到兼容网关不是改一行 baseURL 就完事,流式、工具调用、模型名都要逐项验
- ⚠️ 升级 SDK 前先看 changelog