# よくある質問

## よくあるエラーコード

* **4xx（クライアントエラー状態コード）**：一般的には、リクエストの文法エラー、認証失敗、または認証エラーなどによりリクエストを完了できない場合です。
* **5xx（サーバーエラー状態コード）**：一般的にはサーバー側のエラーで、サーバーの停止、リクエスト処理のタイムアウトなどです。

| エラーコード  | 考えられる状況                                                                                     | 対処方法                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **400** | リクエストボディの形式エラーなど                                                                            | <p>チャットの返却エラー内容を確認するか、 <a href="#kong-zhi-tai-bao-cuo-cha-kan-fang-fa">コンソール\</a でエラー内容を確認し、案内に従って操作してください。</a></p><p><a href="#kong-zhi-tai-bao-cuo-cha-kan-fang-fa"><mark style="color:紫;">【よくあるケース1】</mark>：geminiモデルの場合、カードの登録が必要な場合があります。<br><mark style="color:紫;">【よくあるケース2】</mark>：データ容量が上限を超えています。視覚モデルでよく見られ、画像サイズが上流の単一リクエストの通信上限を超えるとこのエラーコードが返されます。<br><mark style="color:紫;">【よくあるケース3】</mark>：未対応のパラメータを追加した、またはパラメータの入力が誤っている場合です。新しくクリーンなアシスタントを作成して正常かどうか試してください。<br><mark style="color:紫;">【よくあるケース4】：</mark>コンテキストが制限を超えています。コンテキストを消去するか、新しい会話を作成するか、コンテキスト数を減らしてください。</a></p> |
| **401** | 認証失敗：モデルが未対応、またはサーバー側アカウントが停止されているなど                                                        | 対応するサービスプロバイダーのアカウント状態を確認するか、問い合わせてください                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **403** | リクエスト操作の権限がありません                                                                            | 会話の返却エラー情報を確認するか、[コンソール](#kong-zhi-tai-bao-cuo-cha-kan-fang-fa)のエラー表示に従って対応してください                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **404** | リクエスト先のリソースが見つかりません                                                                         | リクエストパスなどを確認してください                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **422** | リクエスト形式は正しいが、意味的に誤っている                                                                      | この種のエラーはサーバー側で解釈できますが、処理できません。JSONの意味エラーでよく見られます（例：null 値、値として文字列が求められているのに数値や真偽値を書いた場合など）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **429** | リクエストレートが上限に達しました                                                                           | リクエストレート（TPM または RPM）が上限に達しています。しばらく時間を置いてから再度お使いください                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **500** | サーバー内部エラーのため、リクエストを完了できません                                                                  | 継続して発生する場合は上流のサービスプロバイダーに連絡してください                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **501** | サーバーは要求された機能をサポートしておらず、リクエストを完了できません                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **502** | ゲートウェイまたはプロキシとして動作するサーバーがリクエストを実行しようとした際、リモートサーバーから無効な応答を受信しました                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **503** | 過負荷またはシステムメンテナンスのため、サーバーが一時的にクライアントのリクエストを処理できません。遅延時間はサーバーの Retry-After ヘッダー情報に含まれる場合があります |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **504** | ゲートウェイまたはプロキシとして動作するサーバーが、リモートサーバーからリクエストを期限内に取得できませんでした                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

***

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

* Cherry Studio のクライアントウィンドウをクリックしてから、ショートカットキーを押します <kbd>Ctrl</kbd> + <kbd>を Shift に、</kbd> + <kbd>I</kbd>（Mac 版：<kbd>Command</kbd> + <kbd>Option</kbd> + <kbd>I</kbd>など）

{% hint style="info" %}

* 現在のアクティブウィンドウは Cherry Studio のクライアントウィンドウである必要があり、そうでないとコンソールを開けません;
* 先にコンソールを開いてから、テストや会話開始などのリクエストを行って、リクエスト情報を取得する必要があります。
  {% endhint %}

- 表示されたコンソールウィンドウで <mark style="color:blue;">`Network`</mark> → ②の最後にある赤い <mark style="color:red;">`×`</mark> が付いた <mark style="color:red;">`completions`</mark>*（会話系、翻訳、モデル接続確認などでエラーが起きた場合）* または <mark style="color:red;">`generations`</mark>*（画像生成でエラーが起きた場合）* モデルサービス<mark style="color:blue;">`Response`</mark>完全な返却内容を確認してください（図中④の領域）。

> このエラーの原因が判断できない場合は、この画面のスクリーンショットを [公式コミュニティ](https://t.me/CherryStudioAI) に送って सहायताを求めてください。

<figure><img src="/files/c6991213fcd2ce8d0f74bd6901b07e8fe226aeeb" alt="" width="563"><figcaption></figcaption></figure>

この確認方法は、会話時だけでなく、モデルのテスト時、ナレッジベース追加時、画像生成時などにも利用できます。どのケースでも、先にデバッグウィンドウを開いてからリクエスト操作を行い、リクエスト情報を取得する必要があります。·

{% hint style="info" %}
異なるシーンでは Name（上図②の位置）欄の名称が異なります

会話、翻訳、モデル確認：<mark style="color:red;">`completions`</mark>

画像生成：<mark style="color:red;">`generations`</mark>

ナレッジベース作成：<mark style="color:red;">`embeddings`</mark>
{% endhint %}

***

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

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

> **区切り記号の使い方**
>
> *インライン数式*
>
> * 単一のドル記号を使用： `$formula$`
> * または`\(` と `\)`を使用します。例：`\(formula\)`
>
> *独立した数式ブロック*
>
> * 二重ドル記号を使用： `$$formula$$`
> * または `\[formula\]`
> * 例： `$$\sum_{i=1}^n x_i$$`\
>   $$\sum\_{i=1}^n x\_i$$

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

***

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

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

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

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

***

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/docs/jp/question-contact/questions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
