TanStack/ai跨模型 TypeScript AI SDK

如果你在写前端，又折腾过好几个 AI 模型服务，大概会碰到同一个麻烦：OpenAI 的 SDK 和 Anthropic 的 SDK 长得不一样，Gemini 又是另一套，切换起来就像换一门语言。TanStack/ai 这个项目想做的，就是把这层差异抹平。

一个与模型供应商无关的 TypeScript SDK

TanStack/ai 是一个 TypeScript 编写的 AI SDK，定位是 type-safe（类型安全） 且 provider-agnostic（不绑定供应商）。也就是说，你的业务代码不用直接跟某个模型厂商的 API 细节绑死，而是通过这套统一接口去对接 OpenAI、Anthropic、Gemini 这些服务。

它对开发者的价值很直接：写一套代码，将来想换模型或同时接多家时，改动量能控制在很小的范围。

除了聊天，还覆盖了哪些能力

从项目描述看，它内置了几类高频能力：

• 流式聊天（streaming chat）——逐字输出，体验更接近 ChatGPT。
• 工具调用（tool calling）——让模型触发外部函数，适合做 Agent。
• 多模态应用（multimodal apps）——文本之外，还能处理图片等输入。
• Agent 开发——在代码里编排多步骤的自主任务。

这些功能并不是堆在一起，而是以类型安全的方式暴露出来，写的时候 IDE 能帮你检查参数和返回结构，减少“字段拼错”这类低级错误。

前端框架适配是它的亮点

现在很多 AI SDK 只提供 Node.js 的 API，到了 React 或 Vue 里还得自己封装。TanStack/ai 的做法是直接适配到常用框架，官方点名的有 React、Vue、Svelte 和 Solid。这对用非 React 技术栈的团队来说特别友好，尤其是 Vue 和 Svelte 社区，可以少写不少胶水代码。

另外，它来自 TanStack 这个开源组织。熟悉前端的人知道，TanStack 的 Query、Router 等库在 React 生态里口碑一直不错，所以这个 AI SDK 的工程味道也值得期待。

适合谁，上手要注意什么

如果你正在做 AI 聊天应用、Agent 或者多模态工具，又希望代码不被某一家模型厂商绑架，这个库值得放进技术选型里比较。因为它是 TypeScript 原生，和前端工程集成会很顺；同时它也支持服务端场景，但具体部署方式要看官方文档的后续更新。

目前项目在 GitHub 上有 3k+ Star，属于比较新的状态，API 还在迭代中。建议在正式项目里使用前先锁版本，并且多关注其 release 记录。想尝鲜的话，直接读它的示例代码比读文档更快。