Vane

TokenMix を OpenAI provider として自托管 answer engine を動かします。

対象ユーザー

自托管の Perplexity 風 answer engine が必要な場合に向いています。検索結果とモデル応答を組み合わせ、研究、情報収集、Web Q&A に使えます。

TokenMix 情報を準備する

• Provider / type: OpenAI Compatible または OpenAI
• Base URL: https://api.tokenmix.ai/v1
• API Key: TokenMix API Key
• Model: TokenMix model ID、例 <your-model-short-id>

各フィールドの意味

• Provider / type はアプリが使う API プロトコルを決めます。Base URL を入力できる OpenAI Compatible、OpenAI、Custom OpenAI を選びます。
• Base URL は実際の API endpoint です。https://api.tokenmix.ai/v1 を使い、OpenAI default endpoint や /v1 抜けを避けます。
• API Key は TokenMix で作成した Key です。公開 repository、スクリーンショット、サンプル、チャットログに入れないでください。
• Model は TokenMix model ID です。アプリ名ではありません。余分な空白や upstream model 名との混同に注意します。
• Embedding は文書検索、knowledge base indexing、類似検索で必要です。最初の chat test では未設定でも構いません。

インストールまたは起動

1. README に従い Docker または Node で起動します。
2. SearXNG などの検索サービスを準備します。
3. ブラウザで Vane を開き、settings に移動します。
4. まず model provider、次に search source を設定します。

デプロイ方式の選び方

• 最も簡単な local option: Vane と SearXNG を含む Docker Bundle。
• 既存 SearXNG がある場合: Docker Slim を使い SEARXNG_API_URL を設定します。
• one-click hosting: Sealos、RepoCloud、ClawCloud、Hostinger。
• developer は Node Local。deploy 後、setup screen で OpenAI provider Base URL を TokenMix に変更します。

TokenMix を設定する

1. OpenAI provider を追加します。
2. API Key に TokenMix API Key を入れます。
3. Base URL は https://api.tokenmix.ai/v1 です。
4. Chat Model は TokenMix chat model ID です。
5. Embedding Model は TokenMix embedding model ID です。
6. モデル一覧が読み込めない場合は model ID を手入力します。

最初のテスト

“what is an OpenAI compatible API base URL” を検索し、出典付きで短く答えてください。

まず 1 回テストを実行します。成功したら、小さな実際の workflow または文書テストを行います。基本呼び出しが動く前に本番データへ接続しないでください。

最初のテスト後に行うこと

• 回答品質を判断する前に、search service が結果を返すか確認します。
• chat model と embedding model の両方を設定します。片方だけだと summary や relevance が不安定になります。
• citation がない場合、model を変える前に search backend を確認します。
• まず public web research に使い、内部 sensitive data はすぐ検索しないでください。

トラブルシューティング

• 401 / unauthorized: Key が間違っている、余分な空白がある、または失効しています。
• model not found: model ID が違う、またはアカウントに権限がありません。
• OpenAI に送信される: Base URL が TokenMix になっていない、または provider が違います。
• 出力が短い / 中断される: 一度に渡す内容を減らすか、context の大きいモデルを使います。

実データ利用前のチェック

• 本番データの前に、test key、test project、sample document、manual trigger で確認します。
• アプリログ、browser Network、terminal output、TokenMix request logs で https://api.tokenmix.ai/v1 に送信されているか確認します。
• 失敗時の表示が分かりやすく、API Key、上流内部情報、local path を露出しないことを確認します。
• メール送信、CRM 更新、DB 書き込み、command 実行ができるアプリは、最初は draft-only または read-only にします。
• 動作確認後、team permissions、budget limits、usage rules を設定し、高権限 Key の共有を避けます。

初心者向け安全策

最初は一時プロジェクト、テスト文書、手動 trigger で確認します。正常に応答できてから、本物のリポジトリ、知識ベース、本番自動化につなぎます。ファイル削除、コマンド実行、メール送信、DB 変更、CRM 操作は、直接実行ではなく先に計画だけ出させてください。