よくある質問

よくあるエラーコード

• 4xx（クライアントエラー状態コード）：一般にリクエストの構文エラー、認可失敗や認証失敗などでリクエストを完了できない場合に発生します。

• 5xx（サーバーエラー状態コード）：一般にサーバー側のエラー、サーバーダウンやリクエスト処理のタイムアウトなど。

エラーコード	考えられる状況	解決方法
400	リクエストボディの形式エラーなど	対話の返却するエラー内容を確認するか、 コンソール</a でエラー内容を確認し、指示に従って操作してください。 【よくあるケース1】：geminiモデルの場合、カード連携（課金情報の紐付け）が必要な可能性があります； 【よくあるケース2】：データ量が上限を超えている。視覚モデルに多く見られ、画像サイズが上流の単一リクエストのトラフィック上限を超えるとこのエラーコードが返されます； 【よくあるケース3】：サポートされていないパラメータを付与した、またはパラメータの記入が誤っている。新規でクリーンなアシスタントを作成して正常かどうか試してみてください； 【よくあるケース4】：コンテキストが制限を超えている。コンテキストをクリアするか、新しい対話を作成するか、コンテキストの件数を減らしてください。
401	認証失敗：モデルがサポートされていない、またはサーバー側アカウントが停止されているなど	対応するサービス提供者に連絡するか、アカウントの状態を確認してください
403	リクエスト操作の権限がない	対話が返すエラー情報に従うか、またはコンソールのエラーメッセージの指示に沿って対応してください
404	リクエストしたリソースが見つからない	リクエストパスなどを確認してください
422	リクエスト形式は正しいが意味的に誤りがある	この種のエラーはサーバーが解析はできるが処理できない場合に発生します。JSONの意味的エラー（例：ヌル値、文字列が要求されている箇所に数値やブール値が書かれているなど）に多く見られます。
429	リクエスト速度が上限に達している	リクエスト速度（TPMまたはRPM）が上限に達しています。少し落ち着いてから再度お試しください。
500	サーバー内部エラーによりリクエストを完了できない	継続的に発生する場合は上流のサービス提供者に連絡してください
501	サーバーがリクエストされた機能をサポートしておらず、リクエストを完了できない
502	ゲートウェイまたはプロキシとして動作するサーバーがリモートサーバーから無効な応答を受け取ったときに発生します
503	過負荷やシステムメンテナンスのため、サーバーが一時的にクライアントのリクエストを処理できない。遅延の長さはサーバーの Retry-After ヘッダーに含まれることがあります
504	ゲートウェイまたはプロキシとして動作するサーバーが、リモートサーバーからのレスポンスをタイムリーに取得できなかった

---

コンソールでのエラー確認方法

• Cherry Studio クライアントウィンドウをクリックした後、ショートカットキーを押します Ctrl + Shift + I（Mac端：Command + Option + I）へ移動してください。

• 現在アクティブなウィンドウが Cherry Studio のクライアントウィンドウでなければコンソールを呼び出せません;

• 先にコンソールを開き、その後テストや対話などのリクエストを行わないとリクエスト情報を収集できません。

• 表示されたコンソールウィンドウで Network → ②の最後に表示されている赤いマークの一番下の項目をクリックして確認します × の completions（対話、翻訳、モデル接続性チェックなどでエラーが発生した場合） または generations（画像生成でエラーが発生した場合） → をクリックし、Responseをクリックして完全な返却内容を確認します（図中④の領域）。

もしそのエラーの原因が判断できない場合は、この画面のスクリーンショットを 公式コミュニティ に送ってサポートを求めてください。

この確認方法は対話時だけでなく、モデルテスト、ナレッジベース追加、画像生成時などにも使用できます。いずれの場合も、先にデバッグウィンドウを開いてからリクエスト操作を行い、リクエスト情報を取得してください。

シーンによっては Name（上図②）の欄の名称が異なります

対話、翻訳、モデルチェック：completions

画像生成：generations

ナレッジベース作成：embeddings

---

式がレンダリングされない／式のレンダリングエラー

• 式がレンダリングされずコードのまま表示される場合は、式に区切り記号があるか確認してください

区切り記号の使い方

インライン数式

• 単一のドル記号を使用： $formula$

• または\( と \)を使用します。例：\(formula\)

独立した数式ブロック

• 二重ドル記号を使用： $$formula$$

• または \[formula\]

• 例： $$\sum_{i=1}^n x_i$$ $\sum_{i=1}^n x_i$

• 式のレンダリングエラー／文字化けは、式内に日本語などの非ASCII文字が含まれる場合に発生しやすいです。KaTeX に切り替えてみてください。

---

ナレッジベースを作成できない／埋め込みの次元取得に失敗する

1. モデルの状態が利用不可

サービス提供者がそのモデルをサポートしているか、またはサービス提供者側でそのモデルのサービスが正常に稼働しているか確認してください。

2. 埋め込みモデル以外を使用している

---

モデルが画像を認識できない／画像のアップロードや選択ができない

まずモデルが画像認識をサポートしているか確認してください。人気のあるモデルでは Cherry Studio がカテゴリ分けを行い、モデル名の後に小さな目のアイコンが付いているものは画像認識をサポートしています。

画像認識対応モデルは画像ファイルのアップロードをサポートします。モデル機能が正しくマッチしていない場合は、該当サービス提供者のモデル一覧でそのモデルを見つけ、名前の横にある設定ボタンをクリックして画像オプションにチェックを入れてください。

モデルの詳細情報は該当サービス提供者で確認できます。埋め込みモデルと同様に、視覚機能をサポートしないモデルでは画像機能を無理に有効にする必要はなく、画像オプションにチェックを入れても効果はありません。