TanStack/ai型安全でAIモデルを乗り換える

OpenAI の SDK と Anthropic の SDK は、似て非なるものだ。エンドポイントも変数名もレスポンスの形も少しずつ違う。複数のモデルを並行して使おうとすると、それぞれの癖を覚えるコストが地味に効いてくる。TanStack/ai は、その手間をまるごと引き受けようという TypeScript ライブラリだ。

モデルは変わる。コードはなるべく変えたくない。

TypeScriptで統一するという発想

このプロジェクトは TanStack が公開した TypeScript 製 AI SDK だ。最大の売りは type-safe（型安全） と provider-agnostic（プロバイダ非依存） という二点に集約される。つまり OpenAI だろうが Anthropic だろうが Gemini だろうが、同じインターフェースから呼び出せる。開発者は特定ベンダーの API ドキュメントに合わせてコードを書き換える代わりに、ここが定めた抽象化レイヤーにだけ向き合えばいい。

チャット以外に何ができるのか

現時点で確認できる主な機能は次のとおり。

• ストリーミングチャット——逐次出力で、ChatGPT に近い体験を実装できる。
• ツール呼び出し（tool calling）——モデルから外部関数を呼び出して Agent 的な動きを作れる。
• マルチモーダル対応——テキストに加えて画像入力なども扱える。
• Agent 開発——複数ステップの自律的なタスクをコードで組み立てられる。

個人的にありがたいのは、こうした機能が型で守られている点だ。ツール呼び出しの引数やレスポンスの形をミスすると、実行時ではなくエディタ上で気づける。ChatGPT の出力が素の JSON で返ってくる時代、型が効くのは結構大きい。

React 以外のフロントエンドにも最初から対応

TanStack/ai の地味に効くポイントは、React だけでなく Vue、Svelte、Solid にも正式対応しているところだ。最近の AI SDK は Node.js だけを想定していることもあるが、このライブラリはフロントエンドに寄せて設計されている。Vue や Svelte を使っている人には、うれしい省エネになる。

そもそも TanStack は React Query を生んだコミュニティだ。テーブルやルーティングでも定評がある。その組織が AI 領域に乗り出したというだけで、設計やテストの質には一定の期待が持てる。

選定するなら今、何を見るべきか

もし AI チャットや Agent、画像入力を含むマルチモーダルなアプリを TypeScript で作るなら、この SDK は技術選定の候補にしていい。ベンダーを一社に絞りたくない、あとで安い方に移りたい、という要件にぴったりだ。

ただし、まだ GitHub の Star が 3k 前後の若いプロジェクトで、API は変わると考えたほうがいい。本番投入するならバージョンを固定して、リリースノートを追う習慣は必須だ。まずはサンプルを動かして、自分のプロジェクトに型がフィットするかを確かめるのが早い。

長く使うかどうかを決めるには、まだ少し時期尚早な気もする。ただ、将来マルチプロバイダで戦う予定があるなら、ウォッチリストに入れておいて損はない。README のサンプルが読める程度のコストで、未来の選択肢が広がる。