よくある質問

よくあるエラーコード

• 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$

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

---

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

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

サービス提供者がそのモデルをサポートしているか、またはそのモデルのサービス状態が正常かどうかを確認してください。

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

---

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

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

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

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