TS 工具包:统一的 generateText / streamText、工具调用、结构化输出(Zod)、React 的 useChat 等 hooks。其 @ai-sdk/openai-compatible 的 createOpenAICompatible({name, apiKey, baseURL}) 就是专为自定义兼容接口设计的。

适用场景:给网站/产品加聊天、流式问答、生成式 UI 的前端/全栈开发者。

typescript nextjs vercel-ai-sdk streaming react

操作步骤

  1. npm install ai @ai-sdk/openai-compatible。
  2. 服务端建 provider:createOpenAICompatible({name: "my-api", apiKey: process.env.{{API_KEY}}, baseURL: "https://tokenbuddy.cc/v1"})。
  3. 用 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

来源:https://www.skills.sh/vercel/ai/ai-sdk