よくある質問

Synthorai に関するよくある質問。

Synthorai はどの SDK をサポートしていますか？

OpenAI SDK（/v1/chat/completions と /v1/responses 経由）と Anthropic SDK（/v1/messages 経由）です。baseURL/base_url をゲートウェイに設定し、ゲートウェイの API key を使用してください — 他のコード変更は不要です。

ツールにはどの base URL を貼り付ければよいですか？

2 つのルールでカバーできます。OpenAI スタイルのツール（Codex、Cursor、Continue、Aider、LangChain ChatOpenAI、生の OpenAI SDK）は origin に /v1 を付けたものを要求します。Anthropic スタイルのツール（Claude Code、Anthropic SDK、LangChain ChatAnthropic）は /v1 を付けない origin を要求します — SDK が自動的に /v1/messages を追加します。Tool Compatibility ページに完全な一覧表があります。 ページを見る →

環境変数を設定しましたが、ツールがまだ元のプロバイダーに接続します。何が抜けているのでしょうか？

新しい環境変数は、プロファイルを編集した後に開いた shell にのみ適用されます。新しいターミナルを開くか、現在のターミナルで source ~/.zshrc / source ~/.bashrc を実行してください。echo $OPENAI_BASE_URL または echo $ANTHROPIC_BASE_URL で確認できます。

自分が利用できるモデル名はどうやって確認できますか？

curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY" を実行するか、Console → Model Pricing を開いてください。id 列の値をリクエストの model パラメータとして渡すと、ゲートウェイが自動的にルーティングします。

Anthropic SDK を Claude 以外のモデルで使えますか？

いいえ。/v1/messages は、設定済みの Anthropic または Bedrock-Anthropic チャネル経由で Claude モデルにのみルーティングします。他のプロバイダーには /v1/chat/completions を使用してください。ルーティング対象のすべてのモデルで動作します。

新しいプロジェクトではどのプロトコルを選ぶべきですか？

最大限の互換性を得るには /v1/chat/completions を使用してください — すべてのプロバイダーで動作します。OpenAI のツール使用と推論には /v1/responses を使用します。Anthropic SDK に統一する場合は /v1/messages を使用してください。

クォータを使い切るとどうなりますか？

リクエストはエラータイプ "quota_exceeded" の 403 ステータスコードを返します。Console → Limits & Billing でチャージできます。

使用量はどのように計算されますか？

使用量は token で計測されます。入力 token と出力 token は別々にカウントされ、各 API レスポンスの usage フィールドで報告されます。

ユーザーごとのクォータを設定できますか？

はい。管理者は Console → Members からユーザーごとの token クォータを設定できます。

リクエストは記録されますか？

はい。すべてのリクエストはモデル、token、レイテンシ、ステータスとともに記録されます。ログは 30 日間保持され、Console → Logs で確認できます。

モデル間で支出を比較したいですか?model price comparison は各ルーティング可能モデルのトークン単価を一覧表示し、LLM API cost calculator はトークン量を月額請求の見積もりに換算します。