> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/question-contact/questions.md).

# よくある質問

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

* **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:青;">`Network`</mark> → ②の位置にある最後の赤色の <mark style="color:赤;">`×`</mark> の <mark style="color:赤;">`completions`</mark>*（対話系、翻訳、モデル接続確認などでエラーが発生したとき）* または <mark style="color:赤;">`generations`</mark>*（画像生成でエラーが発生したとき）* → クリック<mark style="color:青;">`Response`</mark>完全な返却内容を確認します（図中④の領域）。

> そのエラーの原因を判断できない場合は、この画面のスクリーンショットを [公式交流グループ](https://t.me/CherryStudioAI) に送って助けを求めてください。

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

この確認方法は、対話時だけでなく、モデルテスト時、ナレッジベース追加時、画像生成時などにも使えます。どのような場合でも、まずデバッグウィンドウを開き、その後にリクエスト操作を行ってリクエスト情報を取得する必要があります。・

{% hint style="info" %}
シーンによって、Name（上図②の位置）欄の名称は異なります

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

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

ナレッジベース作成：<mark style="color:赤;">`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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/question-contact/questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
