よくある質問

よくあるエラーコード

• 4xx（クライアントエラー状態コード）：一般的には、リクエストの文法エラー、認証失敗、または認証エラーなどによりリクエストを完了できない場合です。

• 5xx（サーバーエラー状態コード）：一般的にはサーバー側のエラーで、サーバーの停止、リクエスト処理のタイムアウトなどです。

エラーコード	考えられる状況	対処方法
400	リクエストボディの形式エラーなど	チャットの返却エラー内容を確認するか、 コンソール</a でエラー内容を確認し、案内に従って操作してください。 【よくあるケース1】：geminiモデルの場合、カードの登録が必要な場合があります。 【よくあるケース2】：データ容量が上限を超えています。視覚モデルでよく見られ、画像サイズが上流の単一リクエストの通信上限を超えるとこのエラーコードが返されます。 【よくあるケース3】：未対応のパラメータを追加した、またはパラメータの入力が誤っている場合です。新しくクリーンなアシスタントを作成して正常かどうか試してください。 【よくあるケース4】：コンテキストが制限を超えています。コンテキストを消去するか、新しい会話を作成するか、コンテキスト数を減らしてください。
401	認証失敗：モデルが未対応、またはサーバー側アカウントが停止されているなど	対応するサービスプロバイダーのアカウント状態を確認するか、問い合わせてください
403	リクエスト操作の権限がありません	会話の返却エラー情報を確認するか、コンソールのエラー表示に従って対応してください
404	リクエスト先のリソースが見つかりません	リクエストパスなどを確認してください
422	リクエスト形式は正しいが、意味的に誤っている	この種のエラーはサーバー側で解釈できますが、処理できません。JSONの意味エラーでよく見られます（例：null 値、値として文字列が求められているのに数値や真偽値を書いた場合など）。
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$

• 数式レンダリングエラー/文字化けは、数式内に中国語が含まれている場合によく発生します。KateX に数式エンジンを切り替えてみてください。

---

ナレッジベースを作成できない/埋め込み次元の取得に失敗しました

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

サービスプロバイダーがそのモデルをサポートしているか、またはそのモデルサービスの状態が正常かを確認してください。

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

---

モデルが画像を認識できない/画像をアップロードまたは選択できない

まず、そのモデルが画像認識に対応しているか確認してください。人気モデルについては Cherry Studio が分類しており、モデル名の後ろに小さな目のアイコンが付いているものは画像認識に対応しています。

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

モデルの詳細情報は、対応するサービスプロバイダーで確認できます。埋め込みモデルと同様に、視覚に対応しないモデルでは画像機能を強制的に有効にする必要はなく、画像オプションにチェックを入れても効果はありません。