よくある質問

よくある質問

よくあるエラーコード

  • 4xx(クライアントエラーステータスコード):一般的にリクエスト構文エラー、認証失敗、認証エラーなどでリクエストを完了できません。

  • 5xx(サーバーエラーステータスコード):一般的にサーバー側のエラーで、サーバーダウン、リクエスト処理のタイムアウトなどが発生します。

エラーコード
想定される状況
解決策

400

リクエストボディの形式エラーなど

対話が返したエラー内容を確認、またはコンソールでエラー内容を確認し、指示に従って操作してください。

【よくある状況1】:Geminiモデルの場合、カード登録が必要な可能性があります; 【よくある状況2】:データ容量超過(画像モデルで頻発)。画像サイズがプロバイダーの単一リクエスト上限を超えた場合に発生; 【よくある状況3】:非対応パラメータ追加またはパラメータ入力ミス。新しいアシスタントで再テストを推奨; 【よくある状況4】:コンテキスト制限超過。コンテキスト消去、新規対話作成、コンテキスト件数削減で対応。

401

認証失敗:非対応モデルまたはサーバーアカウント停止など

該当プロバイダーのアカウント状態を確認

403

操作権限なし

対話が返したエラー情報またはコンソールエラーに従って対応

404

リクエストリソースが見つからない

リクエストパスなどを確認

422

リクエスト形式は正しいが意味的にエラー

サーバーが解釈可能だが処理不能なケース(例:空値必須箇所での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


数式がレンダリングされない/レンダリングエラー

  • 数式コードが直接表示される場合、デリミタの有無を確認

デリミタ利用ガイド

インライン数式

  • 単一ドル記号:$数式$

  • または \(\):例 \(数式\)

独立数式ブロック

  • 二重ドル記号:$$数式$$

  • または \[数式\]

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

  • 数式レンダリングエラー/文字化けは中国語を含む場合に頻発。数式エンジンをKateXに切り替えてください。


ナレッジベース作成不可/埋め込み次元取得失敗

  1. モデル利用不可

プロバイダーがモデルをサポートしているか、およびサービスの正常性を確認してください。

  1. 非埋め込みモデルの使用


モデルが画像認識不可/画像選択・アップロード不可

最初にモデルが画像認識に対応しているか確認します。人気モデルはCherry Studioが自動分類し、モデル名横の👁️アイコンが画像認識対応を示します。

画像認識モデルは画像アップロードをサポートします。モデル分類が誤っている場合は、該当プロバイダーのモデルリストで対象モデル名横の設定ボタンから「画像」オプションを有効化してください。

モデル詳細は各プロバイダーの情報ページで確認できます。埋め込みモデルと同様、画像非対応モデルで画像オプションを有効化しても効果はありません。

最后更新于

这有帮助吗?