https://api.tokios.com/v1 を指定して sk-tok-… キーを貼り付け、Tokios の デプロイメント 名をモデルとして追加すれば、Cherry Studio はホスティングプロバイダではなく、自前のハードウェアで動作するモデルとチャットできます。
前提条件
コネクタがペアリング済み
Cherry Studio からアクセスしたいモデルの隣に
tokios-connector をインストールし、ペアリングします。モデルが登録済み
そのモデルのデプロイメント(公開名)を登録します。
API キーが作成済み
まず
sk-tok-… キーを作成します。必要に応じて、そのデプロイメントにスコープを限定します。サポートされるバックエンド
ローカルバックエンド(Ollama、llama.cpp、vLLM、LM Studio)が動作していることを確認します。
Cherry Studio に Tokios をプロバイダとして追加
1
モデルプロバイダ設定を開く
続いて Settings(設定)(歯車アイコン)を開き、Model Services(モデルサービス)タブに移動します。一部のビルドでは Model Provider(モデルプロバイダ)とラベル付けされている場合があります。Cherry Studio のドキュメントは中国語から翻訳されているため、正確な表記はバージョンによって異なることがあります。
2
プロバイダを追加
まず + Add(追加)をクリックします。Add Provider(プロバイダの追加)ダイアログで、Provider name(プロバイダ名)(例:
Tokios)を入力し、Provider type(プロバイダタイプ)を OpenAI に設定します。これは、汎用の OpenAI 互換エンドポイントに対する設定です。3
API アドレスとキーを設定
プロバイダのフィールドを以下のように埋めます。
必ず
/v1 を API address(API アドレス)に自分で含めてください。Cherry Studio はカスタムプロバイダに対してパスを確実に付加しないため、完全な /v1 ベースを指定してください。4
デプロイメントをモデルとして追加
Cherry Studio はカスタムプロバイダのモデルを自動リストしません。公開デプロイメント名 を使用して手動で追加してください。Models タブで登録したものです(例:
gemma-tunnel)。これは Cherry Studio が model フィールドで送信する値であり、Ollama、llama.cpp、vLLM、LM Studio のローカルモデル ID ではありません。まず
gemma-tunnel は登録したデプロイメント名に、sk-tok-YOUR_KEY は自身のキーに置き換えてください。いずれも共有設定ファイルにコミットしないでください。デスクトップアプリ、モデルは別場所
この構成で解決する一般的なシナリオは以下の通りです。Cherry Studio はノートパソコンやデスクトップで動作しますが、使用したいモデル(そのマシンで実行できるサイズよりも大きい)は、別のワークステーションやサーバ上にあります。そのモデルに隣接するコネクタが Tokios への接続を確立し、Cherry Studio はhttps://api.tokios.com/v1 を sk-tok-… キーで呼び出します。入力しているマシンにローカルではないモデルを、Cherry Studio の UI で使用できます。インバウンドポートや VPN は不要です。
トラブルシューティング
401 エラー
401 エラー
Cherry Studio が送信した API キーが欠落している、形式が不正である、または取り消されています。余分な空白なしで完全な
sk-tok-… キーを貼り付けたことを確認し、Keys タブでそのステータスを確認してください。404 エラー
404 エラー
Cherry Studio が送信したモデル値が登録されたデプロイメントと一致しないか、API address(API アドレス)に
/v1 が含まれていません。モデル名が Models タブの公開名と一致し、アドレスが https://api.tokios.com/v1 であることを確認してください。503 エラー
503 エラー
そのデプロイメントのコネクタがオフラインであるか、並列処理の上限に達しています。Connectors タブを確認してください。コネクタは Online(オンライン)と表示されている必要があり、それを動作させているマシンは稼働中で到達可能である必要があります。
次のステップ
互換性のあるクライアント
他の OpenAI 互換および Anthropic 互換クライアントのベース URL とキーの設定を確認します。
API キー
チームメンバーやエージェント用の
sk-tok-… キーを作成、スコープ設定、ローテーションします。