Cherry Studio
Cherry StudioをRunAPIに接続してチャットを確認します。
カスタムOpenAIプロバイダーでCherry StudioをRunAPIに接続します。続行する前に、認証ガイドで標準のRunAPI APIキーを作成してください。
Cherry Studio のインストール
公式 Cherry Studio ダウンロードガイドに従ってデスクトップアプリケーションをインストールし、設定を開きます。
RunAPI プロバイダーを追加
- 設定 -> モデルサービス -> + 追加を開きます。
- プロバイダー名を
RunAPI、プロバイダータイプを OpenAI に設定します。 - RunAPI の API キーを入力し、API アドレスを
https://runapi.ai/v1に設定します。 - モデルカタログから正確なモデル識別子を追加し、プロバイダーを有効にして保存します。
プロバイダータイプがOpenAIであるため、このフィールドにはRunAPIのOpenAI互換ベースURL（/v1を含む）を使用します。Cherry Studioはチャット補完リクエストに対して/chat/completionsを追加するため、完全な操作URLをAPIアドレスフィールドに貼り付けないでください。
モデルを選択する
カスタムプロバイダーは、追加したモデルに依存します。セレクターが空の場合は、プロバイダーのモデル管理エリアに戻り、RunAPIの識別子を手動で正確に追加してください。モデルを追加しても、そのモデルがサポートしていない機能は付与されません。
接続チェックを実行する
保存済みモデルで接続チェックを実行します。これはキーの形式を検証するだけでなく、モデルリクエストを送信します。チェックが成功すると、プロバイダーURL、キー、および選択したモデルが連携して動作することが確認されます。
接続を確認する
新しいチャットを開始し、RunAPIプロバイダーとモデルを選択してから、Reply
with the word connected.を送信してください。通常の完全またはストリームの返答が返れば、アクティブなチャットがRunAPIを使用していることが確認されます。
トラブルシューティング
- モデルセレクターが空になっている: カスタムプロバイダーのモデル管理エリアに正確なモデル識別子を追加し、プロバイダーが有効になっていることを確認してください。
- 接続チェックに失敗する: モデルが選択されていることを確認し、キーを有効な標準キーに置き換えて再試行してください。
- リクエストが
404を返す: API アドレスとしてhttps://runapi.ai/v1を使用してください。/chat/completionsを自分で追加しないでください。 - Text は動作するが vision またはツールが失敗する: モデルカタログで必要な機能を宣言しているモデルを選択してください。
共通のプロトコル動作については、LLM API クイックスタートを参照してください。リクエストおよびレスポンスのフィールドについては、Chat Completions API リファレンスを参照してください。