Vercel AI SDK

Vercel の AI SDK は、TypeScript で AI 機能を構築するための標準ツールキットです。その @ai-sdk/openai-compatible プロバイダを Synthorai に向けるだけで、カタログのすべてのモデルが 1 つのキーで利用でき、Claude・GPT・Gemini とオープンウェイト系を並べて使えます。

はじめる前に

次の場所で API キーを作成します: コンソール → API Keys. 作成したらすぐにコピーしてください。表示されるのは一度きりです。

ステップ 1 - パッケージのインストール

npm i ai @ai-sdk/openai-compatible

Synthorai は OpenAI Chat Completions のワイヤフォーマットに対応しているため、Synthorai 専用パッケージは不要です。公式の OpenAI 互換プロバイダがサポートされる経路です。

ステップ 2 - プロバイダインスタンスの作成

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

const synthorai = createOpenAICompatible({
  name: 'synthorai',
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

この name の値はトレースやエラーメッセージで使われるラベルで、ルーティングには影響しません。ルーティングを決めるのは baseURL と渡したモデル ID です。

ステップ 3 - テキストの生成とストリーミング

import { generateText } from 'ai';

const { text } = await generateText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Tell me about yourself in one sentence.',
});

console.log(text);

第 1 引数はカタログのモデル ID です。ストリーミングも同じプロバイダインスタンスで、追加設定なしに動作します:

import { streamText } from 'ai';

const result = streamText({
  model: synthorai('claude-sonnet-5-5'),
  prompt: 'Write a short haiku about routing.',
});

for await (const textPart of result.textStream) {
  process.stdout.write(textPart);
}

モデルの選び方

カタログにあるモデル ID はどれも使えます。無難な既定値は次のとおりです:

Anthropic 形式を使う場合

同じキーは別のパスで Anthropic Messages 形式にも対応しており、AI SDK からは Anthropic プロバイダ経由で利用できます。Anthropic 固有の機能が必要なときはそちらを、それ以外は上記の OpenAI 互換プロバイダを使ってください。

import { createAnthropic } from '@ai-sdk/anthropic';

const synthoraiAnthropic = createAnthropic({
  baseURL: 'https://synthorai.io/v1',
  apiKey: process.env.SYNTHORAI_API_KEY,
});

トラブルシューティング

すべての呼び出しが 404 になる。 ベース URL の末尾は /v1. である必要があります。プロバイダは /chat/completions などのパスを追加するため、これがないと誤ったパスになります。

401 Unauthorized が返る。 環境変数はモジュール読み込み時に読まれるため、プロセス起動後に export したキーは反映されません。設定後にプロセスを再起動してください。

モデルが見つからない。 モデル ID は大文字小文字を区別し、カタログと完全に一致する必要があります。キーで到達できるモデルは次で確認できます: curl https://synthorai.io/v1/models -H "Authorization: Bearer $SYNTHORAI_API_KEY"

すべてのモデル ID と価格は model price comparison に掲載しています。