Cherry StudioでGPT・外部APIを接続する方法
適切なプロトコルを選択し、プロバイダーのルート URL を入力し、正確なモデル ID を追加して、セットアップを拡張する前に 1 つの小さなリクエストを確認します。
GPT を Cherry Studio に接続する方法 を検索すると、通常は機能ツアーではなく、機能するプロバイダーの構成が必要になることを意味します。 重要なフィールドは、プロトコル、API キー、ベース URL、および正確なモデル ID です。
短いパスは次のとおりです。
**設定 → モデル サービス → プロバイダーの選択または追加 → 資格情報と API URL を入力 → モデルを取得または追加 → プロバイダーを有効化 → ヘルス チェックを実行します。 **
Cherry Studio には、OpenAI、Anthropic、Google Gemini、DeepSeek、Moonshot、Ollama、LM Studio などのサービス用のプロバイダーが組み込まれています。 ゲートウェイまたはセルフホステッド サービスは、OpenAI 互換、Anthropic、または Gemini エンドポイントを公開する場合、カスタム プロバイダーを通じて追加できます。 現在の UI 名については、公式プロバイダー設定ガイド を参照してください。
Cherry Studioを開く前に必要なもの
使用するサービスから 4 つの値を準備します。
| 値 | それが何を意味するか |
|---|---|
| プロトコル | OpenAI 互換、Anthropic メッセージ、Gemini、またはプロバイダーの文書化された形式 |
| APIキー | リクエストの認証に使用される資格情報 |
| Base URL | プロバイダーが完全なエンドポイントを明示的に要求しない限り、ルート API アドレス |
| Model ID | アップストリームの API によって受け入れられる正確な文字列 |
Web チャットのパスワードを API キーとして使用しないでください。 ChatGPT サブスクリプション、API アカウント、およびサードパーティのゲートウェイは別のアクセス パスです。 選択したサービスによって文書化された認証情報とエンドポイントを使用します。
5 つのステップで GPT を接続する
1. オープンモデルサービス
Cherry Studio を起動し、設定 → モデル サービス を開きます。 OpenAI を直接呼び出す場合は、組み込みの OpenAI プロバイダーを選択します。 ゲートウェイ、アグリゲーター、またはプライベート展開の場合は、プロバイダーの追加 を選択し、別のカスタム エントリを作成します。
プロバイダーは、モデル名の GPT という単語ではなく、プロトコルによって選択されます。 Anthropic 互換ゲートウェイの背後にある GPT ラベル付きモデルには、依然として Anthropic プロトコル プロファイルが必要です。
2. プロバイダーフィールドに入力します
各フィールドについてはプロバイダーのドキュメントを使用してください。
| Cherry Studio フィールド | 何を入力するか | 避ける |
|---|---|---|
| プロバイダ名 | 後でわかるラベル | 無関係なエンドポイントに 1 つのラベルを再利用する |
| APIキー | キー値のみ | 余分なスペース、引用符、または Bearer |
| API型 | エンドポイントが実際に実装するプロトコル | モデルのマーケティング名から推測すると |
| APIアドレス | 文書化されたルート URL または必要な完全な URL | ダッシュボードの URL または重複したパス |
一般的な OpenAI 互換サービスでは、Cherry Studio がルートアドレスにバージョンとリクエストパスを追加します。プロバイダーが https://api.example.com と https://api.example.com/v1/chat/completions, の両方を示す場合、通常の Base URL は前者です。/v1 を重複させず、完全なパスはプロバイダーが明示した場合だけ使用してください。
カスタム プロバイダー ガイド では、追加のエンドポイント、手動モデル エントリ、vLLM スタイルのローカル サービスについて説明しています。
3. モデルを取得または追加します
モデル リストを取得 をクリックします。 エンドポイントがモデル検出を公開する場合は、+ ボタンを使用してモデルを追加します。 返される ID は信頼できるものです。日付、ベンダー プレフィックス、ハイフン、バージョン サフィックスは表示どおりに保持してください。
プロバイダーがモデル リストを公開していない場合は、モデルを手動で追加します。 プロバイダーの保存が成功しても、チャット ピッカーでモデルが自動的に使用可能になるわけではありません。 モデルを追加し、プロバイダー スイッチを有効にする必要があります。
4. 1 つのショート リクエストを確認します
追加したモデルで Check を使用し、最小限のプロンプトを送信します。
Reply with exactly: connection successful
これにより、認証とルーティングの問題が、ビジョン、ツール、長いコンテキスト、またはエージェントの機能の問題から分離されます。 プロバイダーの使用状況ページが利用可能な場合は、そのページで通話を確認します。
5. 高度な機能を一度に 1 つずつ追加します
プレーンテキストが機能した後、ストリーミング、画像、ツール、または推論パラメーターを 1 つずつテストします。 チャット応答が成功したということは、基本的なテキスト ルートが機能していることを証明するだけです。 モデルまたはプロトコルが Cherry Studio が公開するすべての機能をサポートしていることを証明するものではありません。
他のサードパーティ API への接続
OpenAI 互換ゲートウェイ
ゲートウェイが OpenAI Chat Completions または別の OpenAI 互換サーフェスを文書化する場合は、カスタム プロバイダー → OpenAI を使用します。 これは、アグリゲーター、プライベート ゲートウェイ、vLLM、および多くのホストされたオープン モデルの通常のパスです。
マルチプロトコルゲートウェイ
新しい API スタイルのゲートウェイは、OpenAI チャット、OpenAI レスポンス、Anthropic メッセージ、および Gemini ルートを 1 つのルート アドレスから公開できます。 Cherry Studio の 新しい API 手順 では、クライアントが選択したプロトコルのバージョン パスを選択することが説明されています。 ゲートウェイがその契約に従う場合は、NewAPI プリセットを使用します。 文書化されたパスまたはモデル検出のバリエーションがある場合は、カスタム プロバイダーを使用します。
Ollama、LM Studio、および vLLM
一致するローカル プロバイダーを選択するか、ローカル サーバーが OpenAI 互換の API を公開する場合はカスタム OpenAI プロバイダーを使用します。 ローカルサーバーが実際にロードしたモデル名を入力します。 ローカルで実行するとデータの露出を減らすことができますが、ローカル モデルはビジョン、ツール、コンテキストの長さ、推論サポートの点で依然として異なります。
モデルリストが空の場合
次のチェックを順番に実行してください。
- サービスがモデルリスト エンドポイントを実装していることを確認します。 一部の API は、手動で指定したモデル ID のみを受け入れます。
- 重複したパスセグメントを削除します。 すでに
/v1を含むルート URL は、Cherry Studio が別の/v1を追加すると失敗する可能性があります。 - プロバイダーの管理ダッシュボード アドレスではなく、API アドレスを使用していることを確認してください。
- プロバイダーから返された正確なモデル ID をコピーします。 表示名と API ID は互換性がありません。
- プロバイダーが有効になっていることを確認してください。 無効なプロバイダーは、そのモデルをピッカーから非表示にします。
よくあるエラー
| エラー | 考えられる原因 | 最初のチェック |
|---|---|---|
401 Unauthorized | 無効なキー、期限切れのキー、または正しくフォーマットされていないキー | キーを再コピーし、プロトコル プロファイルを確認します |
403 Forbidden | アカウント、プロジェクト、残高、またはキー制限 | プロバイダーの権限と割り当てを確認する |
404 Not Found | 間違ったルート URL、重複したバージョン パス、またはプロトコルの不一致 | 文書化されたベース URL を復元する |
400 Bad Request | サポートされていないパラメータまたはリクエスト形式です | カスタムパラメータを削除してプレーンテキストを再試行してください |
model not found | 間違った ID またはモデルが Cherry Studio に追加されていません | 正確な上流モデル ID をコピーします |
| テキストは機能するが、画像やツールは機能しない | モデルまたはプロトコルにはその機能がありません | 機能リストとルートを確認する |
| タイムアウト | プロバイダーの遅延、ネットワークの問題、またはサイズ超過のリクエスト | 短いプロンプトと 1 つのモデルを使用して再試行してください |
一度に 1 つの変数を変更します。 1 つのプロバイダー、1 つのモデル、および 1 つの短いリクエストから始めます。 その後、複数のモデルまたはツールを追加してください。
複数のモデルを比較する
Cherry Studio を使用すると、会話ピッカーでモデルを切り替え、選択した複数のモデルに同じプロンプトを送信できます。 選択ごとに独立したリクエストが作成されます。 これは比較には役立ちますが、自動投票や品質保証ではありません。 選択したモデルごとに、リクエスト数、コスト、データ露出が増加します。 公式比較ガイド では、どちらの答えが単に「最良」であるかを尋ねるのではなく、明確な評価基準を記述することを推奨しています。
OmniaKey を 1 つのプロバイダーとして使用する
GPT、Claude、Gemini、およびその他のモデルに個別のエントリ ポイントを維持したくない場合は、OmniaKey を Cherry Studio のカスタム OpenAI 互換プロバイダーとして構成します。
- 専用の OmniaKey API キーを作成し、API キー ページで適切なキー制限を設定します。
- Cherry Studio で [設定] → [モデル サービス] → [プロバイダーの追加] を開きます。
- OpenAI 互換タイプを選択し、OmniaKey クイック スタートからベース URL とキーを入力します。
- モデル リストを取得するか、ライブ モデル カタログから正確な ID を追加します。
- プロバイダを有効にし、簡単なチェックを実行して、使用法でリクエストを確認します。
現在の OmniaKey カタログには、Claude、GPT、Gemini、および Grok に加えて、追加のモデル ファミリが含まれています。 ID と機能は動的であるため、古いチュートリアルではなくライブ カタログを使用してください。 OpenAI 互換ルートは、すべてのプロバイダー固有の機能を同一にするわけではありません。 ビジョンやツールを有効にする前に、モデルとプロトコルの機能を確認してください。
よくある質問
Cherry Studio は、見つけた API を使用できますか?
サービスが Cherry Studio がサポートするプロトコルを公開する場合のみ。 文書化されたリクエスト形式、認証方法、モデル ID のない任意の URL では十分ではありません。
ルート URL または /chat/completions を入力する必要がありますか?
プロバイダーのドキュメントに従ってください。 従来のプロバイダーは通常、ルート URL を使用し、Cherry Studio にリクエスト パスを追加させます。 プロバイダーが明示的に要求する場合にのみ、完全なエンドポイントを使用してください。
チャットはできるのに、ツールや画像は使用できないのはなぜですか?
基本的なテキストの成功は、選択したモデル、プロトコル、クライアント ルートがツールやビジョンをサポートしていることを証明するものではありません。 それぞれの機能を個別に確認してください。
ChatGPT Web サブスクリプションは API キーですか?
いいえ。Cherry Studio には、プロバイダー API 資格情報または互換性のあるゲートウェイ資格情報が必要です。 Web ログインの詳細を API キー フィールドに貼り付けないでください。
ソースと鮮度
このガイドでは、Cherry Studio の現在のプロバイダー、カスタム プロバイダー、OpenAI、NewAPI、およびマルチモデルのドキュメントに加えて、OmniaKey の現在の API とモデルのドキュメントを使用します。 モデル ID、プロバイダーの機能、ルートなどの技術的な値は変更される可能性があります。 構成時にそれらを確認してください。