APIゲートウェイ
APIゲートウェイは、Cherry Studio に設定済みのモデル機能を OpenAI および Anthropic 互換の HTTP API としてローカルのプログラムに提供します。これは Agent の実行に必要な内部サービスでもあります。
パス：【設定】→【APIゲートウェイ】。
Agent の使用と外部呼び出しは区別する
Cherry Studio の Agent のみを使う場合：アプリの案内に従って【有効にして起動】するだけでよく、URL やキーを他のプログラムにコピーする必要はありません。
ローカルプログラムから Cherry Studio を呼び出す場合：ゲートウェイを起動し、URL と API キーをコピーして、API ドキュメントに従って互換インターフェースを選択してください。
他のデバイスからアクセスさせる場合：公開範囲が広がるため、ネットワークのリッスン設定、ファイアウォール、アクセス制御を自分で確認する必要があります。安全対策がない状態での公開は推奨しません。
起動と接続
使用シーン：ローカルスクリプトからモデルを呼び出す
まず【設定】→【モデルサービス】でモデルが正常に対話できることを確認してから、API ゲートウェイを起動します。スクリプトはローカルゲートウェイのアドレスとキーだけを保存し、最初にモデル一覧を取得してから、短い文を1つ送信します。完全なプログラムを接続する前に、クライアントが OpenAI 互換または Anthropic 互換のインターフェースをサポートしていることを確認してください。
リッスン範囲
ローカルのみで使用
ネットワークへの露出を減らす
デバッグのために、直接 LAN や公開ネットワークに開放しない
API キー
現在のゲートウェイ専用に保管する
クライアントのリクエストを検証する
リポジトリ、スクリーンショット、共有ログには書き込まない
リクエストを検証する
まずモデル一覧と短いテキストを確認する
接続と生成を分けて検証する
失敗時はステータスコードを記録し、完全なキーは記録しない
完了基準
ゲートウェイが【実行中】と表示される；モデル一覧が読み取れる；短いテキストのリクエストが成功する；ゲートウェイ停止後、クライアントは呼び出しを続けられない。
安全な操作
API キーで、Cherry Studio に設定したモデルサービスを呼び出せます。キーが漏えいした場合は、まずゲートウェイを停止し、停止状態で【再生成】をクリックしてから、すべてのローカルクライアントを更新してください。
ゲートウェイ実行中はポートとキーは読み取り専用なので、変更前に先に停止してください。
公開リポジトリ、Issue、ログ、またはチュートリアルのスクリーンショットでキーを表示しないでください。
呼び出しが必要なプログラムにだけキーを保存する
使用量と費用は実際のモデルサービス提供者によって発生し、【設定】→【使用量統計】で Cherry Studio の記録を確認できます。
最終更新
役に立ちましたか？