https://api.tokios.com/v1 に、キーを sk-tok-… に設定することで、デフォルトのホスト型 API の代わりに、ご自身のハードウェア上のモデルと LobeChat がチャットを行うようになります。
前提条件
コネクタがペアリング済み
LobeChat がアクセスするモデルの横に
tokios-connector をインストールし、ペアリングします。モデルが登録済み
そのモデルのデプロイメント(公開名)を登録します。
API キーが作成済み
まず、
sk-tok-… キーを作成します。必要に応じて、そのデプロイメントにスコープを限定します。サポートされているバックエンド
ローカルバックエンド(Ollama、llama.cpp、vLLM、LM Studio)が実行中であることを確認します。
オプション A — アプリ内で設定する
1
OpenAI プロバイダー設定を開く
LobeChat で Settings → Language Model → OpenAI に移動します。プロバイダーを有効にしてください。
2
API キーとプロキシアドレスを設定する
キーを入力し、プロキシアドレスを Tokios に向けて設定します:この API Proxy Address は LobeChat のベース URL の上書き設定です —
/v1 を含めてください。3
デプロイメントをモデルとして追加する
モデルを 公開デプロイメント名 を使用して追加します。Models タブで登録した — 例えば
gemma-tunnel です。これは LobeChat が model フィールドで送信する値であり、バックエンドのローカルモデル ID ではありません。オプション B — 環境変数で設定する
LobeChat をセルフホストしている場合(Docker など)、アプリ内のフィールドの代わりにこれらの環境変数を設定します:.env
OPENAI_PROXY_URL はベース URL を上書きします(/v1 を含めてください)、OPENAI_MODEL_LIST=+gemma-tunnel はモデルピッカーにデプロイメントを追加します。正確な変数名は LobeChat のリリース間で変更される場合があります — ご使用のバージョンの セルフホスティング モデルプロバイダー ドキュメント で確認してください。
ホスト型 UI、ホームモデル
LobeChat は、ブラウザ、VPS、コンテナなど、便利な場所で実行できます。それでも、自宅のマシン上のモデルにアクセスできます。そのモデル横のコネクタは外向きに Tokios にダイヤルし、LobeChat はキーを使用してhttps://api.tokios.com/v1 を呼び出します。バックエンドを 0.0.0.0 にバインドしたり、着信ポートを開いたり、VPN を設定したりする必要はありません。
トラブルシューティング
401 エラー
401 エラー
LobeChat が送信した API キーが欠落している、形式が正しくない、または取り消されています。キー(アプリ内または
OPENAI_API_KEY)が余分な空白のない完全な sk-tok-… 値であることを確認し、Keys タブでそのステータスを確認してください。404 エラー
404 エラー
モデル値が登録されたデプロイメントと一致しない、またはプロキシアドレスに
/v1 が含まれていません。モデル名が Models タブの公開名と一致し、アドレスが https://api.tokios.com/v1 であることを確認してください。503 エラー
503 エラー
そのデプロイメントのコネクタがオフラインであるか、並列処理の上限に達しています。Connectors タブを確認してください — コネクタは Online と表示される必要があり、それを稼働させているマシンは依然として起動しており、到達可能である必要があります。
次のステップ
互換性のあるクライアント
他の OpenAI および Anthropic 互換クライアントのベース URL とキーの設定を確認します。
API キー
同じ LobeChat インスタンスを使用するチームメンバー用に、個別のスコープ限定キーを作成します。