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 記錄。想嚐鮮的話，直接讀它的示例程式碼比讀文件更快。