Alibaba Cloud Model Studio:エラーメッセージ

400-InvalidParameter

非ストリーミング呼び出しでは、parameter.enable_thinking を false に設定する必要があります／parameter.enable_thinking はストリーミング呼び出しのみをサポートします

原因： 思考モードのモデルに対して、非ストリーミング出力方式で呼び出しが行われました。

解決方法： enable_thinking パラメーターを false に設定するか、ストリーミング 方式を使用してください。

thinking_budget パラメーターの値は正の整数でなければならず、xxx を超えてはいけません

原因： thinking_budget パラメーターの値が有効範囲外です。

解決方法： モデルの最大チェーン・オブ・ソート長については、「モデル」をご参照ください。0 より大きい値かつこの長さ制限を超えない値を指定してください。

このモデルはストリームモードのみをサポートしています。ストリームパラメーターを有効にしてモデルにアクセスしてください。

原因： このモデルは ストリーミング出力 のみをサポートしていますが、呼び出し時にストリーミング出力が有効になっていませんでした。

解決方法： ストリーミング出力 方式でモデルを呼び出してください。

このモデルは enable_search をサポートしていません。

原因： 現在のモデルは Web 検索 機能をサポートしていませんが、enable_search パラメーターが true に設定されています。

解決方法： Web 検索機能をサポートするモデルを呼び出してください。

現在設定されている言語はサポートされていません！

原因： Qwen-MT モデルを使用する際、source_lang または target_lang パラメーターの形式が不正であるか、サポートされる言語一覧 に該当する言語ではありません。

解決方法： 正しい形式で英語名または言語コードを入力してください。

enable_thinking が true の場合、incremental_output パラメーターは "true" でなければなりません

原因： モデルの思考モードが有効になっている場合、増分ストリーミング出力のみがサポートされます。しかし、incremental_output パラメーターが true に設定されていませんでした。

解決方法： incremental_output パラメーターを true に設定して再試行してください。API は増分コンテンツを返します。

このモデルの incremental_output パラメーターは False に設定できません。

原因： このモデルは増分ストリーミング出力のみをサポートしていますが、incremental_output パラメーターが true に設定されていませんでした。

解決方法： incremental_output パラメーターを true に設定して再試行してください。API は増分コンテンツを返します。

入力長の範囲は [1, xxx] でなければなりません

原因： 入力長がモデルの制限を超えています。

解決方法：

• コードからモデルを呼び出す場合、messages 配列内のトークン数がモデルの最大入力トークン制限内であることを確認してください。

• Chatbox などのチャットクライアントや Model Studio コンソールで継続的な会話を実行する場合、各リクエストには会話履歴が含まれます。これにより、リクエストがモデルの制限を超える可能性があります。制限を超えた場合は、新しい会話を開始してください。

max_tokens の範囲は [1, xxx] でなければなりません

原因： max_tokens パラメーターの値が [1, モデルの最大出力トークン数] の範囲外です。

解決方法： max_tokens パラメーターを、「モデル」に記載されているモデルの「Max input」に基づいて設定してください。

temperature は [0.0, 2.0) の範囲内である必要があります／'temperature' は Float 型でなければなりません

原因： temperature パラメーターの値が [0.0, 2.0) の範囲外です。

解決方法： temperature パラメーターを 0 以上 2 未満の数値に設定してください。

top_p の範囲は (0.0, 1.0] でなければなりません／'top_p' は Float 型でなければなりません

原因： top_p パラメーターの値が (0.0, 1.0] の範囲外です。

解決方法： top_p パラメーターを 0 より大きく 1 以下である数値に設定してください。

パラメーター top_k は 0 以上でなければなりません

原因： top_k パラメーターが 0 未満の数値に設定されています。

解決方法： top_k パラメーターを 0 以上の数値に設定してください。

repetition_penalty は 0.0 より大きくなければなりません

原因： repetition_penalty パラメーターが 0 以下に設定されています。

解決方法： repetition_penalty パラメーターを 0 より大きい数値に設定してください。

presence_penalty は [-2.0, 2.0] の範囲内である必要があります

原因： presence_penalty パラメーターの値が [-2.0, 2.0] の範囲外です。

解決方法： presence_penalty パラメーターを [-2.0, 2.0] の範囲内の値に設定してください。

n の範囲は [1, 4] でなければなりません

原因： n パラメーターの値が [1, 4] の範囲外です。

解決方法： n パラメーターを [1, 4] の範囲内の値に設定してください。

seed の範囲は [0, 9223372036854775807] でなければなりません

原因： DashScope プロトコルを使用する場合、seed パラメーターの値が [0, 9223372036854775807] の範囲外です。

解決方法： seed パラメーターを [0, 9223372036854775807] の範囲内の値に設定してください。

リクエストメソッド 'GET' はサポートされていません。

原因： 現在の API は GET リクエストメソッドをサポートしていません。

解決方法： API リファレンスを参照し、POST など、サポートされているリクエストメソッドを使用して再度リクエストを送信してください。

role が "tool" のメッセージは、先行する "tool_calls" を含むメッセージに対する応答でなければなりません

原因： ツール呼び出し中にアシスタントメッセージが messages 配列に追加されていませんでした。

解決方法： ツールメッセージを追加する前に、モデルの最初のターン応答からのアシスタントメッセージを messages 配列に追加してください。

必須のリクエストボディが無効です。リクエストボディの形式を確認してください。

原因： リクエストボディの形式が API の要件を満たしていません。

解決方法： リクエストボディが標準 JSON 文字列であることを確認してください。一般的な問題として、余分なカンマ (,) や閉じていない括弧があります。リクエストボディの形式を修正する際は、大規模言語モデル を活用できます。

input コンテンツは文字列でなければなりません。

原因： テキスト専用モデルでは、messages 内のコンテンツを文字列以外の型に設定することはできません。

解決方法： [{"type": "text","text": "あなたは誰ですか？"}] のような配列型にコンテンツを設定しないでください。

content フィールドは必須フィールドです。

原因： リクエスト内で content パラメーターが指定されていません（例：{"role": "user"}）。

解決方法： content パラメーターを指定してください。例：{"role": "user","content": "あなたは誰ですか"}。

現在のユーザー API は HTTP 呼び出しをサポートしていません。

原因： 現在のモデルは非ストリーミング出力をサポートしていません。

解決方法： ストリーミング出力 を使用してください。

"prompt" または "messages" のいずれかが存在する必要があり、両方とも null であってはなりません

原因： 大規模言語モデルを呼び出す際、messages パラメーターも prompt パラメーター（非推奨）も指定されていません。このエラーが messages パラメーターを指定した後に発生した場合、その形式が不正である可能性があります。例えば、DashScope-HTTP を使用する場合、messages は input オブジェクト内に配置する必要があり、model パラメーターと同じレベルには配置できません。

解決方法： messages パラメーターを指定してください。パラメーターを指定済みにもかかわらずエラーが継続する場合は、「Qwen」API リファレンスを参照し、その配置が正しいかどうかを確認してください。

'messages' には 'json_object' 型の 'response_format' を使用する場合、何らかの形で 'json' という単語を含める必要があります。

原因： 構造化出力 を使用する際、プロンプトに json キーワードが含まれていません。

解決方法： 「JSON 形式で出力してください」のように、プロンプトに json（大文字小文字を区別しない）を追加してください。

enable_thinking が true の場合、JSON モードの応答はサポートされていません

原因： 構造化出力 を使用する際に、モデルの思考モードが有効になっています。

解決策: 構造化出力を使用する場合、 enable_thinking を false に設定して思考モードを無効にします。 詳細については、「思考モードでは、モデルはどのように構造化出力を生成しますか?」をご参照ください。

ツール名には [search] を使用できません

原因： ツール名を search に設定することはできません。

解決方法： search 以外の値をツール名に設定してください。

response_format の形式が不明です。response_format は dict 型で、'type' を含み、任意で 'json_schema' キーを含む必要があります。ユーザーが指定した response_format の type は xxx です。

原因： 指定された response_format パラメーターが無効です。

解決方法： 構造化出力 機能を利用する場合、response_format パラメーターを {"type": "json_object"} に設定してください。

enable_thinking パラメーターの値は True に限定されます。

原因： qwen3-235b-a22b-thinking-2507 のような一部のモデルでは、enable_thinking パラメーターを false に設定できません。

解決方法：

• Cherry Studio などのサードパーティツールからモデルを呼び出す場合、入力ボックスで思考スイッチをオンにしてください。

• コードからモデルを呼び出す場合、enable_thinking を true に設定してください。

'audio' 出力は stream=true の場合のみサポートされます

原因： Qwen-Omni モデルはストリーミング出力のみをサポートしていますが、それを使用していません。

解決方法： stream パラメーターを true に設定してください。

tool_choice は ["none", "auto"] のいずれかの文字列でなければなりません

原因： 関数呼び出しリクエストで指定された tool_choice パラメーターが不正です。

解決方法： 「auto」（モデルがツールを選択）または「none」（モデルがツールを使用しないように強制）を指定してください。

モデルが見つかりません

原因： 指定された model パラメーターが存在しないか、形式が不正です。

解決方法：

• モデル名の形式： model パラメーターが正しい大文字小文字で記述され、余分な空白が含まれていないことを確認してください。

• 正しいモデル名： 正しい model 名を確認するため、「モデル」をご参照ください。オープンソースコミュニティのモデル名と Model Studio のモデル ID を混同しないでください。例： qwen3-235b-a22b-instruct-2507 を使用し、Qwen/Qwen3-235B-A22B-Instruct-2507 を使用しないでください。

思考モードのモデルを呼び出す場合、result_format パラメーターは "message" でなければなりません

原因： 思考モードのモデルを呼び出す際、result_format パラメーターが "message" に設定されていませんでした。

解決方法： result_format パラメーターを "message" に設定してください。

音声が空です

原因： 入力音声が短すぎて、サンプリングポイント数が不足しています。

解決方法： 音声の持続時間を延長してください。

ファイル解析中です。しばらくしてから再度お試しください。

原因： Qwen-Long モデルを使用する場合、ファイルの解析が完了していません。

解決方法： ファイルの解析が完了するまで待ってから、再度 API を呼び出してください。

"stop" パラメーターは "str"、"list[str]"、"list[int]"、または "list[list[int]]" のいずれかの型でなければならず、リスト内のすべての要素は同じ型でなければなりません。

原因： stop パラメーターが str、list[str]、list[int],、または list[list[int]] の形式に準拠していません。

解決方法： 「Qwen」API リファレンスを参照し、stop パラメーターを正しい形式に設定してください。

値エラー：バッチサイズが無効です。これは xxx よりも大きくしてはいけません。

原因： 埋め込みモデルを呼び出す場合、テキストの数がモデルの制限を超えています。

解決方法： 「埋め込み」でモデルの バッチサイズ を確認し、入力テキストの数を制御してください。

[] が短すぎます

原因： 入力 messages 配列が空です。

解決方法： リクエストを送信する前に、メッセージを追加してください。

ツール呼び出しはサポートされていません。

原因： モデルは tools パラメーターをサポートしていません。

解決方法： ツール呼び出しをサポートする Qwen または DeepSeek モデルに切り替えてください。

必須パラメーター(xxx)が不足しているか無効です。リクエストパラメーターを確認してください。

原因： API 呼び出しのパラメーターが無効です。

解決方法： 必須パラメーターがすべて提供され、正しい形式であることを確認してください。

入力には file_urls を含める必要があります

原因： 音声ファイル認識（Paraformer）を使用する場合、file_urls リクエストパラメーターに値が割り当てられていません。

解決方法： リクエストに file_urls パラメーターを含め、それに値を割り当ててください。

提供された URL は有効でないようです。正しい形式であることを確認してください。

原因： 視覚理解、マルチモーダル、または音声理解モデルを使用する場合、入力データの URL またはローカルパスが無効であるか、要件を満たしていません。

解決方法：

• 入力 URL： URL は http://、https://、または data: で始まる必要があります。data: で始まる場合、Base64 エンコードされたデータの前に "base64" を含める必要があります。

• 入力ローカルパス： パスは file:// で始まる必要があります。

• 入力一時 URL：

  • HTTP 呼び出しの場合、リクエストヘッダーに X-DashScope-OssResourceResolve: enable パラメーターを追加してください。

  • SDK 呼び出しの場合、DashScope SDK のみがサポートされています。OpenAI SDK は使用しないでください。

入力は有効な辞書または GPT3Message のインスタンスである必要があります

原因： messages フィールドの形式が要件を満たしていません。例えば、括弧の数が一致していない、または必須のキーと値のペアが欠落しているなどです。

解決方法： messages フィールドの JSON 構造が正しいことを確認してください。

値エラー：contents は文字列でも文字列の配列でもありません。: input.contents

原因： 埋め込みモデルを使用する場合、入力が文字列または文字列の配列ではありません。

解決方法： 入力形式を文字列または文字列の配列に変更してください。

マルチモーダルコンテンツのダウンロードに失敗しました。/ データ検査プロセス中にメディアリソースのダウンロードがタイムアウトしました。/ データ検査プロセス中にメディアリソースをダウンロードできませんでした。

原因： 画像、動画、または音声のダウンロードに失敗したか、ダウンロードがタイムアウトしました。

• 接続の問題： Object Storage Service の内部ネットワークアドレスを使用しています。

• ネットワーク遅延： クロスリージョンアクセスによりタイムアウトが発生しています。

• サービスの不安定性： ソースストレージサービスの応答が遅いか、到達不能です。

解決方法：

• ストレージサービスの変更

  モデルサービスと同じリージョンにあるストレージサービスを使用してください。公開 URL を生成するために Object Storage Service を使用してください。プライベートネットワークアドレスは使用しないでください。

• 転送方法の調整

  公開 URL を使用してファイルを転送できない場合は、下記の表に示す推奨方法に切り替えてください。詳細については、「ローカルファイルの渡し方（Base64 エンコーディングまたはファイルパス）」をご参照ください。

  タイプ	仕様	DashScope SDK（Python、Java）	OpenAI 互換 / DashScope HTTP
  画像	7 MB より大きく、10 MB 未満	ローカルパスを渡す	公開 URL のみをサポート。 Object Storage Service を使用してください。
  	7 MB 未満	ローカルパスを渡す	Base64 エンコーディング
  動画	100 MB を超える	公開 URL のみをサポート。 Object Storage Service を使用してください。	公開 URL のみをサポート。 Object Storage Service を使用してください。
  	7 MB より大きく、100 MB 未満	ローカルパスを渡す	公開 URL のみをサポート。 Object Storage Service を使用してください。
  	7 MB 未満	ローカルパスを渡す	Base64 エンコーディング
  音声	10 MB を超える	公開 URL のみをサポート。 Object Storage Service を使用してください。	公開 URL のみをサポート。 Object Storage Service を使用してください。
  	7 MB より大きく、10 MB 未満	ローカルパスを渡す	公開 URL のみをサポート。 Object Storage Service を使用してください。
  	7 MB 未満	ローカルパスを渡す	Base64 エンコーディング

  Base64 エンコーディングはデータサイズを増加させます。そのため、元のファイルは 7 MB より小さくなければなりません。

  Base64 エンコーディングまたはローカルファイルパスを使用することで、サーバー側のダウンロードタイムアウトを回避し、安定性を向上させることができます。

URL エラー、URL を確認してください！

• 理由 1：モデル名と API エンドポイントが一致しません。 例えば、マルチモーダルエンドポイントを使用してプレーンテキストモデルを呼び出そうとしている、またはプレーンテキストエンドポイントを使用してマルチモーダルモデルを呼び出そうとしている場合です。

  解決方法：

  1. DashScope を使用して qwen3.5-plus や qwen3-vl-plus などのマルチモーダルモデルを呼び出す場合、MultiModalConversation.call() メソッドまたはマルチモーダル生成エンドポイントを使用する必要があります。「画像および動画の理解」をご参照ください。

     spring-ai-alibaba フレームワークを使用する場合、マルチモーダルパラメーター withMultiModel を設定していることを確認してください。

  2. DashScope を使用して qwen3-max、qwen-plus、deepseek-v3.2 などのプレーンテキストモデルを呼び出す場合、Generation.call() またはテキスト生成エンドポイントを使用する必要があります。「テキスト生成の概要」をご参照ください。

  3. DashScope を使用して CosyVoice のボイスクローン API を呼び出す場合、API には model および target_model パラメーターが含まれます。model を voice-enrollment に設定します。target_model を特定の CosyVoice モデルに設定します。「CosyVoice ボイスクローンおよびボイスデザイン API」をご参照ください。

• 理由 2：DashScope SDK のバージョンが古くなっています。 古い SDK バージョンでは、画像または動画生成モデルを呼び出す際に、サーバー側の正しいアドレスを解決できません。

  解決方法： 「SDK のインストール」をご参照ください。

入力データのスタイルを確認してください。

原因： 入力パラメーターが要件を満たしていません。

解決方法： 入力パラメーターを確認・修正してください。

モデル事前処理中にエラーが発生しました。

原因： content フィールドが不正な形式で渡されました。

解決方法：

• コードから呼び出す場合、[{"type": "text", "text": "あなたは誰ですか？"}] のような配列型に content を設定しないでください。

データ検査においてサポートされていない画像サイズです。

原因：

• Qwen-VL モデルに渡された画像の寸法（縦と横）がモデルの要件を満たしていません。

• 出力画像サイズが制限（10 MB）を超えています。

解決方法：

• 画像の寸法は以下の要件を満たす必要があります：

  • 画像の幅と高さはともに少なくとも 10 ピクセルでなければなりません。

  • 縦横比は 200:1 または 1:200 を超えてはいけません。

• 画像を生成するためのパラメーターを調整してください。

必須パラメーター(data_sources) が不足しているか無効です。リクエストパラメーターを確認してください。

原因： SubmitIndexJob API を呼び出した際に、CreateIndex API を呼び出す際に必須パラメーター SourceType が指定されていない場合にこのエラーが返されます。

解決方法： 与えられたドキュメントからナレッジベースを作成する場合、このパラメーターを DATA_CENTER_FILE に設定する必要があります。与えられたカテゴリからナレッジベースを作成する場合、このパラメーターを DATA_CENTER_CATEGORY に設定する必要があります。詳細については、「CreateIndex」のドキュメントをご参照ください。

マルチモーダル URL の Content-Type が不正です

原因： URL リクエストのレスポンスヘッダー内の Content-Type フィールドが不正です。

Qwen-VL モデルは、image/bmp、image/icns、image/x-icon、image/jpeg、image/jp2、image/png、image/sgi、image/tiff、image/webp の Content-Type をサポートしています。詳細については、「Qwen-VL モデルがサポートする画像」をご参照ください。

解決方法：

必須フィールド：image_url

原因： 入力パラメーター image_url が不足しています。

解決方法： 「絵文字動画生成」を参照し、image_url を指定してください。

必須フィールド：driven_id

原因： 入力パラメーター driven_id が不足しています。

解決方法： 「絵文字動画生成」を参照し、driven_id を指定してください。

無効な ext_bbox

原因： ext_bbox 入力パラメーターが無効です。

解決方法： 「絵文字動画生成」を参照し、有効な ext_bbox を指定してください。

Driven が存在しません：driven_id

原因： driven_id 入力パラメーターが存在しません。

解決方法： 「絵文字動画生成」を参照し、有効な driven_id を指定してください。

テキストリクエスト制限違反、予期される値は 1 です。

原因： CosyVoice 音声合成サービスへの WebSocket API 呼び出しにおいて、enable_ssml を true に設定した後に、`continue-task` 命令を複数回送信しています。

解決方法： enable_ssml を true に設定した場合、`continue-task` 命令は 1 回のみ送信してください。

SSML テキストは現時点ではサポートされていません！

原因： CosyVoice 音声合成を使用する場合、現在のモデルまたはボイスは SSML をサポートしていません。または、SSML が正しく使用されていません。

解決方法： 「制限事項」をご参照ください。

400-invalid_request_error-invalid_value

-1 は最小値 0 より小さい - 'seed'/'seed' は Integer 型でなければなりません

原因： OpenAI 互換プロトコルを使用する場合、seed パラメーターの値が [0, 2³¹-1] の範囲外です。

解決方法： seed パラメーターを [0, 2³¹-1] の範囲内の値に設定してください。

400-invalid_request_error

model パラメーターを指定する必要があります。

原因： リクエスト内で model パラメーターが提供されていません。

解決方法： リクエストに model パラメーターを追加してください。

400-InvalidParameter.NotSupportEnableThinking

モデル xxx は enable_thinking をサポートしていません。

原因： 現在のモデルは enable_thinking パラメーターの設定をサポートしていません。

解決方法： リクエストから enable_thinking パラメーターを削除するか、思考モードをサポートするモデルを使用してください。

400-invalid_value

要求されたボイス 'xxx' はサポートされていません。

原因： Qwen-TTS を使用してリアルタイム合成を行う場合、選択したボイスは別のモデルによって生成されています。

解決方法： ボイスクローンのリクエストパラメーター target_model と音声合成のリクエストパラメーター model が同一であることを確認してください。

400-Arrearage

アクセスが拒否されました。アカウントの支払い状況をご確認ください。

原因： ご利用の Alibaba Cloud アカウントに支払い遅延があるため、アクセスが拒否されています。

解決方法： 課金管理 ページにアクセスし、支払い遅延がないか確認してください。

• 支払い遅延がない場合：API キーが現在のアカウントに属しているかを確認してください。

• 支払い遅延がある場合：アカウントに資金を追加してください。アカウント残高が更新されるまで数分待ち、その後再試行してください。

400-DataInspectionFailed/data_inspection_failed

入力または出力データに不適切なコンテンツが含まれている可能性があります。/ 入力データに不適切なコンテンツが含まれている可能性があります。/ 出力データに不適切なコンテンツが含まれている可能性があります。

原因： 入力または出力に、コンテンツモデレーションによってブロックされたと思われるセンシティブなコンテンツが含まれています。

解決方法： 入力コンテンツを修正して再試行してください。

入力 xxx データに不適切なコンテンツが含まれている可能性があります。

原因： プロンプトや画像などの入力データに、センシティブなコンテンツが含まれている可能性があります。解決方法： コンテンツコンプライアンスチェックを実施し、入力を修正して再試行してください。

400-APIConnectionError

接続エラー。

原因： オンプレミスネットワークの問題で、通常はプロキシが有効になっていることが原因です。

解決方法： プロキシを無効化または再起動してください。

400-InvalidFile.DownloadFailed

音声ファイルをダウンロードできません。

原因： 音声認識（Paraformer） を使用して音声ファイル認識を行う場合、認識対象のファイルのダウンロードに失敗しました。

解決方法： 音声ファイル URL がパブリックネットワークからアクセス可能かを確認してください。

400-InvalidFile.AudioLengthError

音声の長さは 1 秒から 300 秒の間でなければなりません。

原因： 音声の長さが要件を満たしていません。

解決方法： 音声の持続時間が [1, 300] 秒の範囲内であることを確認してください。

音声の長さは 1 秒から 180 秒の間でなければなりません。

原因： 音声の長さが要件を満たしていません。

解決方法： 音声の持続時間が [1, 180] 秒の範囲内であることを確認してください。

400-InvalidFile.NoHuman

入力画像に人物が含まれていません。単一の人物が写っている画像をアップロードしてください。

原因： 入力画像に人物が写っていないか、顔が検出されませんでした。

解決方法： 単一の人物が写っている写真をアップロードしてください。

400-InvalidFile.BodyProportion

画像内の検出された人物の比率が大きすぎたり小さすぎたりします。他の画像をアップロードしてください。

原因： アップロードした画像内の人物の比率が要件を満たしていません。

解決方法： 人物の比率が要件を満たす画像をアップロードしてください。

400-InvalidFile.FacePose

検出された顔のポーズが無効です。正面を向いた顔がはっきりと写っている画像をアップロードしてください。

原因： アップロードした画像内の人物の顔のポーズが要件を満たしていません。顔がはっきりと見え、頭部の向きが極端に傾いていない必要があります。

解決方法： 要件を満たす画像をアップロードしてください。

検出された顔のポーズが無効です。期待される向きの顔が写っている画像をアップロードしてください。

原因： アップロードした画像内の人物の顔のポーズが要件を満たしていません。頭部の向きが傾いていない必要があります。

解決方法： 画像内の人物の顔が傾いていないことを確認してください。

検出された顔のポーズが無効です。期待される向きの顔が写っている画像をアップロードしてください。

原因： アップロードした画像内の人物の顔のポーズが要件を満たしていません。頭部の向きが傾いていない必要があります。

解決方法： 画像内の人物の顔が傾いていないことを確認してください。

400-InvalidFile.Resolution

画像の解像度が無効です。画像の最大辺の長さは 7000 より小さく、最小辺の長さは 400 より大きくしてください。

原因： アップロードした画像サイズが要件を満たしていません。

解決方法： アップロードした画像の解像度は 7,000×7,000 を超えてはいけません。また、400×400 を下回ってはいけません。

画像の解像度が無効です。画像の最大辺の長さは 4096 より小さく、最小辺の長さは 224 より大きくしてください。

原因： アップロードした画像サイズが要件を満たしていません。

解決方法： アップロードした画像の最大辺の長さは 4,096 ピクセルより小さくする必要があります。最小辺の長さは 224 ピクセルより大きくする必要があります。

画像の解像度が無効です。画像の最大辺の長さは xxx より小さく、最小辺の長さは yyy より大きくしてください。

原因： アップロードした画像サイズが要件を満たしていません。

解決方法： アップロードした画像の解像度は xxx×xxx を超えてはいけません。また、yyy×yyy を下回ってはいけません。

画像の解像度が無効です。画像の縦横比は xxx より小さく、最大辺の長さは yyy より小さくしてください。

原因： アップロードした画像サイズが要件を満たしていません。

解決方法： アップロードした画像の縦横比は xxx より小さくする必要があります。また、解像度は yyy×yyy を超えてはいけません。

無効な動画解像度。動画の高さまたは幅は xxx ~ yyy でなければなりません。

原因： 動画の解像度が要件を満たしていません。

解決方法： 動画の辺の長さは xxx から yyy の間でなければなりません。

400-InvalidFile.FPS

無効な動画 FPS。動画の FPS は 15 ~ 60 でなければなりません。

原因： 動画のフレームレートが要件を満たしていません。

解決方法： 動画のフレームレートは 15 から 60 fps の間でなければなりません。

400-InvalidFile.Value

画像の値が無効です。より鮮明な画像をアップロードしてください。

原因： アップロードした画像が暗すぎて、要件を満たしていません。

解決方法： 画像内の人物の顔がはっきりと見えることを確認してください。

400-InvalidFile.FrontBody

検出された人物のポーズが無効です。正面を向いている画像をアップロードしてください。

原因： アップロードした画像内の人物がカメラに向かって背面を向けているため、要件を満たしていません。

解決方法： 画像内の人物がカメラに向かって正面を向いていることを確認してください。

400-InvalidFile.FullFace

検出された顔のポーズが無効です。顔全体が写っている画像をアップロードしてください。

原因： アップロードした画像内の人物の顔のポーズが要件を満たしていません。顔がはっきりと見えている必要があります。

解決方法： 画像内の人物の顔全体がはっきりと見え、遮られていないことを確認してください。

400-InvalidFile.FaceNotMatch

参照画像と動画内の顔が一致しません。

原因： 参照画像の顔と動画の顔が一致しません。

解決方法： 「VideoRetalk 動画生成」をご参照ください。

400-InvalidFile.Content

入力動画の最初のフレームに人物が写っていません。他のクリップを選択してください。

原因： 動画の最初のフレームには人物が写っている必要があります。

解決方法： 人物が写っている動画クリップを選択してください。

入力動画の最初のフレームに写っている人物が小さすぎます。他のクリップを選択してください。

原因： 動画の最初のフレームに写っている人物が小さすぎます。

解決方法： 最初のフレームに写っている人物がより大きな動画を選択してください。

入力動画の最初のフレームに写っている人物がはっきりと写っていません。他のクリップを選択してください。

原因： 動画の最初のフレームに写っている人物がはっきりと写っていません。

解決方法： 最初のフレームに写っている人物がはっきりと写っている動画を選択してください。

入力画像に人物が写っていません。または複数の人物が写っています。単一の人物が写っている画像をアップロードしてください。

原因： 入力画像に人物が写っていないか、複数の人物が写っています。

解決方法： 単一の人物が写っている写真をアップロードしてください。

入力画像に人物が写っていません。または人物がはっきりと写っていません。他の画像をアップロードしてください。

原因： 入力画像内の人物が不完全であるか、人物が写っていません。

解決方法： 完全で、はっきりと写っている人物が写っている画像をアップロードしてください。

入力画像に複数の人物が写っています。単一の人物が写っている画像をアップロードしてください。

原因： 入力画像に複数の人物が写っています。

解決方法： 単一の人物が写っている写真をアップロードしてください。

400-InvalidFile.FullBody

入力動画の最初のフレームに写っている人物が全身ではありません。他のクリップを選択してください。

原因： 動画の最初のフレームに写っている人物が全身ショットではありません。

解決方法： 人物の全身がはっきりと見えるようにしてください。

検出された人物のポーズが無効です。全身が写っている画像をアップロードするか、アスペクト比パラメーターを 1:1 に変更してください。

原因： アップロードした画像内の人物のポーズが要件を満たしていません。

解決方法： 要件を満たす画像をアップロードしてください。顔のショットの場合は、顔全体がはっきりと写っている必要があります。上半身のショットの場合は、腰から上がはっきりと写っている必要があります。または、アスペクト比を 1:1 に変更してください。

400-InvalidFile.BodyPose

検出された人物のポーズが無効です。全身が写っていて、期待される向きの画像をアップロードしてください。

原因： 単一の人物の動作が要件を満たしていません。

解決方法： 要件を満たす画像をアップロードしてください。肩と足首がはっきりと写っている必要があります。また、人物が背面を向いていたり、座っていたり、極端に傾いていたりしてはいけません。

400-InvalidFile.Size

無効なファイルサイズ。動画ファイルのサイズは 200MB 未満、音声ファイルのサイズは 15MB 未満でなければなりません。

原因： ファイルサイズが要件を満たしていません。

解決方法： 動画ファイルは 200 MB 未満、音声ファイルは 15 MB 未満である必要があります。

無効なファイルサイズ。画像ファイルのサイズは 5MB 未満でなければなりません。

原因： ファイルサイズが要件を満たしていません。

解決方法： 画像ファイルは 5 MB 未満である必要があります。

無効なファイルサイズ。動画／音声／画像ファイルのサイズは xxxMB 未満でなければなりません。

原因： ファイルサイズが要件を満たしていません。

解決方法： 動画、音声、または画像ファイルは指定されたメガバイト数未満である必要があります。

400-InvalidFile.Duration

無効なファイル持続時間。ファイルの持続時間は xxx s ~ yyy s でなければなりません。

原因： ファイルの持続時間が要件を満たしていません。

解決方法： 動画または音声ファイルの持続時間は xxx から yyy 秒の間でなければなりません。

400-InvalidFile.ImageSize

画像サイズが制限を超えています。

原因： 画像サイズが制限を超えています。

解決方法： 画像の縦横比は 2 を超えてはいけません。また、最長辺は 4096 を超えてはいけません。

400-InvalidFile.AspectRatio

無効なファイル比率。ファイルの縦横比（高さ／幅）は 3:1 から 1:3 の間でなければなりません。

原因： ファイルの縦横比が要件を満たしていません。

解決方法： 動画ファイルの縦横比は 3:1 から 1:3 の間でなければなりません。

無効なファイルの縦横比。ファイルの縦横比（高さ/幅）は、0.5 から 2.0 の間である必要があります。

原因： ファイルの縦横比が要件を満たしていません。

解決方法： 画像ファイルの縦横比は 2.0 から 0.5 の間でなければなりません。

400-InvalidFile.Openerror

無効なファイルです。ファイルを動画／音声／画像として開けません。

原因： ファイルを開けません。

解決方法： ファイルが破損していないか、フォーマットが正しいかを確認してください。

400-InvalidFile.Template.Content

無効なテンプレートコンテンツ。

原因： アクションテンプレートに対する権限がありません。または、テンプレートコンテンツが要件を満たしていません。

解決方法： テンプレートの権限とコンテンツを確認してください。

400-InvalidFile.Format

無効なファイルフォーマット。リクエストファイルフォーマットは、MP4、AVI、MOV、MP3、WAV、AAC、JPEG、JPG、PNG、BMP、WEBP のいずれかである必要があります。

原因： ファイルフォーマットが要件を満たしていません。

解決方法： 要件を満たすファイルを使用してください。サポートされる動画フォーマットは mp4、avi、mov です。サポートされる音声フォーマットは mp3、wav、aac です。サポートされる画像フォーマットは jpg、jpeg、png、bmp、webp です。

400-InvalidFile.MultiHuman

入力画像に複数の人物が写っています。単一の人物が写っている画像をアップロードしてください。

原因： 入力画像に複数の人物が写っています。

解決方法： 単一の人物が写っている写真をアップロードしてください。

400-InvalidPerson

入力画像に人物が写っていません。または複数の人物が写っています。単一の人物が写っている画像をアップロードしてください。

原因： 入力画像に人物が写っていないか、複数の人物が写っています。

解決方法： 単一の人物が写っている写真をアップロードしてください。

400-InvalidParameter.DataInspection

データ検査プロセス中にメディアリソースをダウンロードできませんでした。

原因： 画像または音声ファイルのダウンロードがタイムアウトしました。

解決方法： 中国国外からの呼び出しでは、不安定なクロスボーダーネットワークにより、リソースのダウンロードがタイムアウトすることがあります。ファイルを中国国内の OSS バケットに保存してからモデルを呼び出すか、一時ストレージ を使用してファイルをアップロードしてください。

400-FlowNotPublished

フローはまだ公開されていません。フローを公開してから再度お試しください。

原因： フローが公開されていません。

解決方法： フローを公開してから再度お試しください。

400-InvalidImage.ImageSize

画像サイズが制限を超えています。

原因： 画像サイズが制限を超えています。

解決方法： 画像の縦横比は 2 を超えてはいけません。また、最長辺は 4096 を超えてはいけません。

400-InvalidImage.NoHumanFace

人物の顔が検出されませんでした。

原因： 人物の顔が検出されませんでした。これは、生成タスクの非同期クエリ API のみで発生します。

解決方法： はっきりと写っている人物の顔が写っている画像をアップロードしてください。

400-InvalidImageResolution

入力画像の解像度が大きすぎたり小さすぎたりします。

原因： 入力画像の解像度が大きすぎたり小さすぎたりします。

解決方法： 画像解像度は 256 × 256 ピクセルを下回ってはいけません。また、5760 × 3240 ピクセルを上回ってはいけません。

400-InvalidImageFormat

入力画像のフォーマットが無効です。

原因： 画像フォーマットが要件を満たしていません。

解決方法： JPEG、PNG、JPG、BMP、WEBP 形式の画像を使用してください。

400-InvalidURL

リクエストで提供された URL が無効です。

原因： URL が無効です。

解決策: 有効な URL を使用してください。

必須 URL が不足しているか無効です。リクエスト URL を確認してください。

原因： 入力 URL が無効であるか、不足しています。

解決方法： 正しい URL を提供してください。

リクエスト URL が無効です。URL が正しいこと、および画像であることを確認してください。

原因： 入力 URL が無効です。

解決方法： URL が正しいこと、および画像ファイルを指していることを確認してください。

入力音声が xx 秒より長いです。

原因： 入力音声ファイルが最大持続時間 xx 秒を超えています。

解決方法： 音声ファイルを xx 秒以内にトリミングしてください。

ファイルサイズが 15MB より大きいです。

原因： 入力音声ファイルが最大制限 15 MB を超えています。

解決方法： 音声ファイルを 15 MB 以内に圧縮してください。

ファイルタイプはサポートされていません。許可されているタイプは：.wav、.mp3 です。

原因： 入力音声フォーマットが無効です。

解決方法： 現在、wav および mp3 フォーマットのみがサポートされています。

リクエスト URL が無効です。リクエスト URL が利用可能であり、リクエスト画像フォーマットが JPEG、JPG、PNG、BMP、WEBP のいずれかのタイプであることを確認してください。

原因： 画像にアクセスできないか、ダウンロードされたファイルフォーマットがサポートされていません。

解決方法： URL にアクセス可能であり、画像フォーマットが JPEG、JPG、PNG、BMP、WEBP のいずれかであることを確認してください。

400-InvalidImage.FileFormat

無効な画像タイプ。アップロードされたファイルが有効な画像であることを確認してください。

原因： 画像フォーマットがサポートされていません。

解決方法： JPG、JPEG、PNG、BMP、または WEBP 画像を使用してください。

400-InvalidURL.ConnectionRefused

xxx への接続が拒否されました。利用可能な URL を提供してください。

原因： ダウンロードが拒否されました。

解決方法： 利用可能な URL を提供してください。

400-InvalidURL.Timeout

xxx のダウンロードがタイムアウトしました。ネットワーク接続を確認してください。

原因： ダウンロードがタイムアウトしました。

解決方法： ネットワーク接続を確認してください。

400-BadRequestException

無効なパートタイプ。

原因： これは、Qwen-Long モデルの会話シナリオでのみ発生し、ユーザーが現在 Qwen-Long モデルでサポートされていないファイルタイプをアップロードした場合に発生します。

解決方法： Qwen-Long でサポートされているファイルタイプをアップロードしてください。

400-BadRequest.EmptyInput

必須の入力パラメーターがリクエストから不足しています。

原因： input パラメーターがリクエストに追加されていませんでした。

解決方法： リクエストに input パラメーターを追加してください。

400-BadRequest.EmptyParameters

必須パラメーター "parameters" がリクエストから不足しています。

原因： parameters パラメーターがリクエストに追加されていませんでした。

解決方法： リクエストに parameters パラメーターを追加してください。

400-BadRequest.EmptyModel

必須パラメーター "model" がリクエストから不足しています。

原因： model パラメーターがリクエストで提供されていませんでした。

解決方法： リクエストに model パラメーターを追加してください。

400-BadRequest.IllegalInput

入力パラメーターは JSON 形式が必要です。

原因： 入力パラメーターの形式が API で要求される JSON 形式に準拠していません。

解決方法： 入力パラメーターの形式が標準 JSON であることを確認してください。

400-BadRequest.InputDownloadFailed

入力ファイルのダウンロードに失敗しました：xxx。

原因： 入力ファイルのダウンロードに失敗しました。ダウンロードのタイムアウト、ダウンロードの失敗、またはファイルがサイズクォータを超過したことが原因である可能性があります。

解決方法： 詳細なエラーメッセージ xxx に基づいてトラブルシューティングを行ってください。

入力ファイルのダウンロードに失敗しました。

原因： Qwen-TTS を使用してボイスクローンを行う際、サーバーがクローン対象の音声をダウンロードできませんでした。

解決方法： 音声ファイルがダウンロード可能であること、およびそのサイズが 10 MB の制限を超えていないことを確認してください。

400-BadRequest.UnsupportedFileFormat

ファイル形式はサポートされていません。

原因： CosyVoice ボイスクローン を実行する際、アップロードされた音声フォーマットがモデルの要件を満たしていません。

解決方法： 音声フォーマットは WAV (16-bit)、MP3、または M4A である必要があります。ファイル名拡張子だけでフォーマットを判断できないことに注意してください。例えば、.mp3 拡張子のファイルが Opus などの別のフォーマットである場合があります。ffprobe や mediainfo などのツール、または Linux/macOS の file コマンドを使用して、音声ファイルの実際のエンコード形式を確認し、要件を満たしていることを確認することを推奨します。

入力ファイル形式はサポートされていません。

原因： 入力ファイルの形式がサポートされていません。

解決方法： サポートされているファイル形式を使用してください。

400-BadRequest.TooLarge

ペイロードが大きすぎます。

原因： ファイルサイズが制限を超えています。

解決方法：

• "purpose" パラメーターが "file-extract" の場合、ドキュメントは 150 MB、画像は 20 MB を超えてはいけません。

• "purpose" パラメーターが "batch" の場合、ファイルは 500 MB を超えてはいけません。ファイルを分割し、ファイルをバッチでアップロード してください。

400-BadRequest.ResourceNotExist

必須リソースが存在しません。

原因：

• CosyVoice ボイスクローン の更新、クエリ、または削除 API を呼び出す際、対応するボイスが存在しません。

• カスタムボキャブラリ（Paraformer） を使用する際、更新、クエリ、または削除 API によって呼び出されたカスタムボキャブラリリソースが存在しません。

400-Throttling.AllocationQuota

現在のクォータは xxx です

原因： CosyVoice ボイスクローン のボイス数が制限に達しました。

解決方法： 一部のボイスを削除してください。

無料割り当てクォータを超過しました。

原因： カスタムボキャブラリ（Paraformer） を使用する際、カスタムボキャブラリの数が上限を超えました。デフォルトでは、アカウントごとに 10 個です。

解決方法： 一部のカスタムボキャブラリを削除してください。

最大ボイスストレージ制限を超過しました。既存のボイスを削除してください。

原因： Qwen-TTS を使用してボイスクローンを行う際、ご利用の Alibaba Cloud アカウントがボイス数制限を超えています。

解決方法： 一部のボイスを削除するか、クォータの増加をリクエストしてください。

400-InvalidGarment

衣類画像が不足しています。少なくとも 1 つの上半身または下半身の衣類画像を入力してください。

原因： 衣類画像が不足しています。

解決方法： 少なくとも 1 つの上半身の衣類画像（top_garment_url）または下半身の衣類画像（bottom_garment_url）を提供してください。

400-InvalidSchema

text2sql のデータベーススキーマが無効です。

原因： データベーススキーマ情報が入力されていませんでした。

解決方法： データベーススキーマ情報を入力してください。

400-InvalidSchemaFormat

text2sql のデータベーススキーマ形式が無効です。

原因： 入力データテーブル情報の形式が異常です。

解決方法： データテーブル情報の形式を確認・修正してください。

400-Audio.AudioShortError

有効な音声が短すぎます！

原因： CosyVoice ボイスクローン に使用される音声の有効な持続時間が短すぎます。

解決方法： 音声の持続時間は 10 秒から 15 秒の間に制御してください。録音する際は、流暢に話し、少なくとも 5 秒以上の連続した発話セグメントを含めるようにしてください。

400-Audio.AudioSilentError

無音音声エラー。

原因： CosyVoice ボイスクローン の音声ファイルが無音であるか、非無音部分の長さが短すぎます。

解決方法： ボイスクローン用の音声の持続時間は 10 秒から 15 秒の間に制御し、少なくとも 5 秒以上の連続した発話セグメントを含めるようにしてください。

400-InvalidInputLength

画像の解像度が無効です。画像の最大辺の長さは 4096 より小さく、最小辺の長さは 150 より大きくしてください。また、画像サイズは 5KB から 5MB の範囲でなければなりません。

原因： 画像の寸法またはファイルサイズが要件を満たしていません。

解決方法： 「入力画像の要件」をご参照ください。

400-FaqRuleBlocked

入力または出力データが FAQ ルールによってブロックされました。

原因： FAQ ルール介入モジュールがヒットしました。

400-ClientDisconnect

タスク完了前にクライアントが切断されました！

原因： タスクが完了する前にクライアントが能動的に切断しました。このエラーメッセージは、音声合成または認識サービスを使用する際に生成されます。

解決方法： コードを確認し、タスクが完了する前にサーバーから切断しないようにしてください。

400-ServiceUnavailableError

Role は user または assistant でなければならず、Content の長さは 0 より大きくなければなりません。

原因： 入力コンテンツの長さが 0 であるか、role が不正です。

解決方法： 入力コンテンツの長さが 0 より大きいことを確認し、role などのパラメーター形式が API リファレンスの要件を満たしていることを確認してください。

400-IPInfringementSuspect

入力データに IP 侵害の疑いがあります。

原因： プロンプトや画像などの入力データに知的財産権侵害の疑いがあります。

解決方法： コンテンツコンプライアンスチェックを実施してください。入力に侵害リスクのあるコンテンツが含まれていないことを確認してください。

400-UnsupportedOperation

参照オブジェクトではこの操作はサポートされていません。

原因： 関連付けられたオブジェクトがこの操作をサポートしていません。

解決方法： 操作オブジェクトと操作タイプが一致しているかを確認してください。

ファインチューンジョブは、成功、失敗、またはキャンセルされたため削除できません。

原因： このファインチューニングタスクは、すでに「成功」、「失敗」、または「キャンセル済み」の状態であるため、削除できません。

解決方法： 特定の状態のタスクのみ削除できます。終了状態のタスクは削除しないでください。

400-CustomRoleBlocked

入力または出力データにカスタムルールによる不適切なコンテンツが含まれている可能性があります。

原因： リクエストまたはレスポンスのコンテンツがカスタムポリシーを通過しませんでした。

解決方法： コンテンツを確認するか、カスタムポリシーを調整してください。

400-Audio.PreprocessError

音声前処理エラー。

原因： Qwen-TTS を使用してボイスクローンを行う際、音声の前処理に失敗しました。考えられる理由：text パラメーターが音声と大きく異なる、有効な人間の発話が短すぎる、または音声ファイルに音が含まれていない。

解決方法： text パラメーターを調整してください。問題が解決しない場合は、録音ガイドを参照して音声を再度録音してください。

最小持続時間要件を満たすセグメントがありません

原因： Qwen-TTS を使用してボイスクローンを行う際、クローン対象の音声における有効な人間の発話が短すぎます。

解決方法： 録音ガイドを参照して音声を再度録音してください。

400-BadRequest.VoiceNotFound

ボイス '%s' が見つかりません。

原因： Qwen-TTS を使用してボイスクローンを行う際、ボイス削除インターフェースを呼び出しましたが、そのボイスはすでに削除されているか、存在しません。

解決方法： voice パラメーターが正しいことを確認してください。

400-Audio.DecoderError

音声ファイルのデコードに失敗しました。

原因： Qwen-TTS を使用してボイスクローンを行う際、音声のデコードに失敗しました。/ CosyVoice ボイスクローンファイルのデコードに失敗しました。

解決方法： 音声ファイルが破損していないかを確認し、必要なファイル形式を満たしていることを確認してください。例えば、Qwen-TTS には特定の要件があり、CosyVoice は WAV (16-bit)、MP3、または M4A をサポートしています。

400-Audio.AudioRateError

ファイルサンプルレートはサポートされていません。

原因： Qwen-TTS または CosyVoice を使用してボイスクローンを行う際、音声ファイルのサンプルレートがサポートされていません。

解決方法： サンプルレートが 24000 Hz 以上であることを確認してください。

400-Audio.DurationLimitError

音声の持続時間が最大許容制限を超えています。

原因： Qwen-TTS を使用してボイスクローンを行う際、クローン対象の音声が長すぎます。

解決方法： 音声が 60 秒以内であることを確認してください。

401-InvalidApiKey/invalid_api_key

提供された API キーが無効です。/ 不正な API キーが提供されました。

原因： API キーが不正です。

解決方法： 一般的な原因とその解決策は以下の通りです：

• 環境変数が不正です

  • 不正な例： api_key=os.getenv("sk-xxx") 。sk-xxx は環境変数の名前として扱われ、キーとしては扱われません。

  • 正しい例：

    • 環境変数をエクスポートしている場合： api_key=os.getenv("DASHSCOPE_API_KEY") と記述してください。

      DASHSCOPE_API_KEY

    • 環境変数をエクスポートしていない場合： api_key = "sk-xxx" と記述してください。

      この方法は本番環境では使用しないでください。

• 不正な入力： Model Studio の API キーは sk- で始まります。別のプロバイダーの API キーを入力した可能性があります。

• Coding Plan 専用 API キー： Coding Plan は専用の API キー（sk-sp- で始まる）を提供します。一般的な API キーとは異なり、この専用キーは専用の API エンドポイント（例：https://coding-intl.dashscope.aliyuncs.com/v1）で使用する必要があります。API キーとベース URL の両方を更新していることを確認してください。手順については、「AI ツールのセットアップ」をご参照ください。

• リージョンの不一致: API キーとベース URL が異なるリージョンに属しています。たとえば、中国 (北京) リージョンの API キーをシンガポール リージョンのベース URL とともに使用している可能性があります。国際リージョンのベース URL には -intl が含まれます。API キーが Singapore リージョンページまたは Beijing リージョンページにあることを確認してください。各リージョンのベース URL は以下のとおりです:

  リージョン	OpenAI 互換	DashScope
  国際 (シンガポール)	https://dashscope-intl.aliyuncs.com/compatible-mode/v1	https://dashscope-intl.aliyuncs.com/api/v1
  中国 (北京)	https://dashscope.aliyuncs.com/compatible-mode/v1	https://dashscope.aliyuncs.com/api/v1

• ツールの互換性に関する問題: サードパーティ製ツールが正しく設定されていません。 たとえば、Dify の最新プラグイン版は不安定であるため、TONGYI プラグインの以前のバージョンをインストールしてください。または、Cline の以前のバージョンでは、[API プロバイダー] を [Alibaba Qwen] ではなく [OpenAI 互換] に設定します。

上記のいずれにも該当しない場合、API キーが削除されている可能性があります。新しい API キーを取得し、再度 API を呼び出してみてください。

401-NOT AUTHORIZED

アクセス拒否：このワークスペースへのアクセス権限がないか、ワークスペースが存在しません。以下を確認してください：\nワークスペースの構成を確認してください。\nAPI エンドポイントの設定を確認してください。正しい環境をターゲットにしていることを確認してください。

原因：

• WorkspaceId の値が無効であるか、現在のアカウントがこのワークスペースのメンバーではありません。

• リクエストされたエンドポイントが不正です。

解決方法：

• WorkspaceId の値が正しいこと、およびアカウントがワークスペースのメンバーであることを確認し、再度 API を呼び出してください。

• 中国サイトのユーザーは、中国 (北京) リージョンのエンドポイントを使用する必要があります。国際サイトのユーザーは、シンガポールリージョンのエンドポイントを使用する必要があります。API デバッグ を使用する際は、エンドポイントが正しいこと（以下の図に示す通り）を確認してください。

  

403-AccessDenied/access_denied

現在のユーザー API は非同期呼び出しをサポートしていません。

原因： API は非同期呼び出しをサポートしていません。

解決方法： リクエストヘッダーから X-DashScope-Async を削除するか、その値を disable に設定してください。

現在のユーザー API は同期呼び出しをサポートしていません。

原因： API は同期呼び出しをサポートしていません。

解決方法： リクエストヘッダーで X-DashScope-Async: enable を設定してください。

ポリシーに従って無効：ポリシーの有効期限が切れました。

原因： 一時的な公開 URL を取得する際に、ファイルのアップロード認証情報が期限切れになっています。

解決方法： ファイルアップロード認証情報 API を再度呼び出して、新しい認証情報を生成してください。

アクセス拒否。

理由： このモデルに必要な権限がないか、モデルの無料枠が使い果たされており、有料利用（例：deepseek-r1-distill-llama-70b）をサポートしていないため、アクセスが拒否されています。

403-AccessDenied.Unpurchased

モデルへのアクセスが拒否されました。モデルを使用する資格があることを確認してください。

原因： Alibaba Cloud Model Studio サービスをまだアクティブ化していません。

解決方法： Model Studio サービスをアクティブ化するには、以下の手順を実行してください。

1. アカウントの登録： Alibaba Cloud アカウントをお持ちでない場合は、まず 登録 する必要があります。

2. リージョンの選択： Model Studio は 国際版 (シンガポール) と 中国本土版 (北京) を提供しています。両エディションは、コンソール、エンドポイント、モデル、およびその料金体系が異なります。「モデル」をご参照ください。

   • 国際版： エンドポイントとモデルサービスは、中国本土を除く国際リージョンに配置されています。デフォルトのエンドポイントはシンガポールです。

   • 中国本土版： エンドポイントとモデルサービスは中国本土に配置されています。現在、北京エンドポイントのみがサポートされています。

3. アカウント認証の完了： 中国本土版 をアクティブ化するには、この手順が必要です。国際版 をアクティブ化する場合は、この手順をスキップできます。

   Alibaba Cloud アカウント を使用して アカウント認証 を完了してください：

   • [個人認証] または [企業版へのアップグレード] を選択し、[今すぐ認証] をクリックします。

   • 表示されたページの[追加情報]セクションで、[中国本土でのクラウドリソースの購入またはアクセラレーションの有効化]で[はい]を選択します。

   • その他の項目については、「アカウント認証の概要」をご参照ください。

4. Model Studio のアクティブ化： Alibaba Cloud アカウント を使用して、Model Studio コンソール（シンガポール または 北京）に移動します。利用規約を読んで同意すると、Model Studio は自動的にアクティブ化されます。利用規約が表示されない場合、Model Studio はすでにアクティブ化されています。

403-Model.AccessDenied

モデルアクセス拒否。

原因： 対応する標準モデル を呼び出す権限がありません。

解決方法：

• 標準モデルの呼び出し： サブワークスペースの API キーを使用して qwen-plus などの標準モデルを呼び出す場合、サブワークスペースがそのモデルを呼び出す権限を持っている必要があります。詳細については、「サブワークスペースにモデルを呼び出す権限を付与する」をご参照ください。

403-App.AccessDenied

アプリへのアクセスが拒否されました。

原因： アプリケーションまたはモデルにアクセスする権限がありません。

解決方法：

• ワークスペースと RAM ユーザーにアクセス権限が付与されていることを慎重に確認してください。

• アプリケーションが公開されていることを慎重に確認してください。

• 渡された APP ID と API KEY が正しいことを慎重に確認してください。

• Claude Code がエラーを報告する場合、デフォルトのワークスペースの API キーを使用してください。

• 上記のすべての提案が正しい場合、データをリフレッシュし、再公開してから再度呼び出すか、エージェントを再度作成することを推奨します。

403-Workspace.AccessDenied

ワークスペースへのアクセスが拒否されました。

原因： ワークスペースのアプリケーションまたはモデルにアクセスする権限がありません。

解決方法：

• サブワークスペース内のモデルを呼び出す場合、「サブワークスペースでモデルを呼び出す」をご参照ください。

• すべてのワークスペースに対する権限を持つ Alibaba Cloud アカウントの API キーを使用することもできます。

403-AllocationQuota.FreeTierOnly

モデルの無料枠が使い果たされました。有料でモデルへのアクセスを継続したい場合は、管理コンソールで「無料枠のみ使用」モードを無効にしてください。

原因： 無料枠のみ 機能が有効になっており、無料枠が使い果たされた後にリクエストが送信されました。

コンソールでの無料枠の表示には 1 時間の遅延があります。クォータが使い果たされていても、インターフェースにはまだ残りのクォータが表示される場合があります。

解決方法：

• 有料呼び出しを開始するには、コンソールで無料枠がなくなるまで待ってください。その後、無料枠のみ をオフにしてください。

• Coding Plan を使用中にこの問題が発生した場合、通常は設定ミスが原因です。Coding Plan には独自のベース URL と API キー が必要です。「クイックスタート」をご参照ください。

404-ModelNotFound/model_not_found

提供されたモデル xxx はバッチ API でサポートされていません。

原因： 現在のモデルはバッチ呼び出しをサポートしていないか、モデル名が誤入力されている可能性があります。

解決方法： バッチ呼び出しをサポートするモデルとその正しい名前を確認するには、「OpenAI 互換 - バッチ (ファイル入力)」をご参照ください。

モデルが見つかりません。/ モデル xxx は存在しません。/ モデル xxx は存在しないか、アクセス権限がありません。

原因： アクセスしようとしているモデルが存在しないか、Model Studio サービスをまだアクティブ化していません。

解決方法：

• 「モデル」でモデル名を確認し、入力したモデル名（model パラメーターの値）が正しいことを確認してください。

• コンソールの [モデル] ページに移動して、モデルサービスをアクティブ化してください。

404-model_not_supported

OpenAI 互換モードでは、サポートされていないモデル xxx です。

原因： 現在のモデルは OpenAI 互換モードでのアクセスをサポートしていません。

解決方法： DashScope メソッドを使用してモデルを呼び出してください。

404-WorkSpaceNotFound

ワークスペースが見つかりません。

原因： ワークスペースが存在しません。

404-NotFound

見つかりません！

原因：

• クエリまたは操作対象のリソースが存在しません。

• カスタムボキャブラリを使用する際、渡されたカスタムボキャブラリ ID が無効であるか、対応するカスタムボキャブラリが存在しません。

解決方法：

• クエリまたは操作対象のリソースの ID が不正でないかを確認してください。

• カスタムボキャブラリ ID が正しいこと、および API リファレンスに従って正しい方法で呼び出されていることを確認してください。

429-Throttling

リクエストの速度制限がトリガーされました。

原因： API 呼び出しがレート制限をトリガーしました。

解決方法： 呼び出し頻度を減らすか、後で再試行してください。

ルート内のリクエストが多すぎます。後で再試行してください。

原因： リクエストが多すぎてレート制限がトリガーされました。

解決方法： 後で再試行してください。

429-Throttling.RateQuota/LimitRequests/limit_requests

リクエスト制限を超過しました。/ リクエストレート制限を超過しました。後で再試行してください。/ 現在のリクエストリストを超過しました。

原因： 呼び出し頻度、1 秒あたりのリクエスト数 (RPS) または 1 分あたりのリクエスト数 (RPM) がレート制限をトリガーしました。

解決方法： 詳細については、「レート制限」をご参照ください。呼び出し頻度を制御してください。

429-Throttling.BurstRate/limit_burst_rate

リクエストレートが急激に増加しました。システムの安定性を確保するため、クライアントロジックを調整して、リクエストを時間とともにスムーズにスケーリングしてください。

原因： レート制限に達していないにもかかわらず、呼び出し頻度が急激に増加し、システムの安定性保護メカニズムがトリガーされました。

解決方法： クライアントの呼び出しロジックを最適化し、均一なスケジューリング、指数バックオフ、リクエストキューバッファリングなどのスムーズなリクエスト戦略を採用して、時間枠内でリクエストを均等に分散させ、瞬間的なピークを回避することを推奨します。

429-Throttling.AllocationQuota/insufficient_quota

割り当てられたクォータを超過しました。クォータ制限を増やしてください。/ 現在のクォータを超過しました。プランと課金詳細を確認してください。

原因： 1 秒あたりまたは 1 分あたりの消費トークン数 (TPS/TPM) が レート制限 をトリガーしました。

解決方法： 詳細については、「トークンはどのように計算されますか？」をご参照ください。また、レート制限 ルールに従って呼び出し戦略を調整してください。

リクエストが多すぎます。システム容量制限により、バッチリクエストが速度制限されています。後で再試行してください。

原因： バッチリクエストが多すぎてレート制限がトリガーされました。

解決方法： 現在、リクエストを処理できません。後で再試行してください。

無料割り当てクォータを超過しました。

原因： 無料枠の有効期限が切れたか、使い果たされており、モデルは現在、従量課金方式をサポートしていません。

解決方法： 別のモデルを代替として使用してください。例えば、Qwen-Audio モデルのクォータが使い果たされた場合、マルチモーダル モデルを使用できます。

429-CommodityNotPurchased

商品がまだ購入されていません。

原因： ワークスペースがサブスクライブされていません。

解決方法： まずワークスペースサービスをサブスクライブしてください。

429-PrepaidBillOverdue

プリペイド請求書の支払いが遅延しています。

原因： ワークスペースのサブスクリプション請求書の有効期限が切れました。

429-PostpaidBillOverdue

ポストペイド請求書の支払いが遅延しています。

原因： モデル推論製品の有効期限が切れました。

430-Audio.DecoderError

音声ファイルのデコードに失敗しました。

原因： CosyVoice ボイスクローン の音声ファイルのデコードに失敗しました。

解決方法： ffprobe や mediainfo などのツール、または Linux/macOS の file コマンドを使用して、音声ファイルの実際のエンコード形式を確認し、要件を満たしていることを確認することを推奨します。

430-Audio.FileSizeExceed

ファイルが大きすぎます

原因： CosyVoice ボイスクローン の音声ファイルサイズが制限を超えています。

解決方法： ボイスクローン用の音声ファイルは 10 MB 以内である必要があります。

430-Audio.AudioRateError

ファイルサンプルレートはサポートされていません

原因： CosyVoice ボイスクローン の音声ファイルのサンプルレートがサポートされていません。

解決方法： サンプルレートを 16 kHz 以上に設定してください。

430-Audio.AudioSilentError

無音ファイルはサポートされていません。

原因： CosyVoice ボイスクローン の音声ファイルが無音であるか、非無音部分の長さが短すぎます。

解決方法： 音声の持続時間は 10 秒から 15 秒の間に制御し、少なくとも 5 秒以上の連続した発話セグメントを含めるようにしてください。

500-InternalError/internal_error

内部エラーが発生しました。後で再試行するか、サービスサポートにお問い合わせください。

原因： 内部エラーが発生しました。

解決方法：

• Qwen-Omni モデル を使用している場合、ストリーミング出力方式を使用する必要があります。

• CosyVoice ボイスクローン を使用している場合、考えられる原因は以下の通りです：

  • 音声ファイルが標準ではありません。例えば、音自体に問題がある、ノイズがある、または音が変動するなどです。録音ガイド を参照して再試行してください。

  • 録音ファイルの URL にアクセスできません。CosyVoice ボイスクローンおよびボイスデザイン API の指示に従って再試行してください。

  • 録音ファイルが長すぎます。10 秒から 15 秒の録音を選択するようにしてください。録音する際は、流暢に話し、少なくとも 5 秒以上の連続した発話セグメントを含めるようにしてください。

内部サーバーエラー！

原因： 内部アルゴリズムエラーが発生しました。

解決方法： 後で再試行してください。

音声前処理サーバーエラー

CosyVoice ボイスクローン を使用している場合：

• 原因： 音声ファイルが標準ではありません。例えば、音自体に問題がある、ノイズがある、または音が変動するなどです。

  解決方法： 詳細については、録音ガイド を参照してください。再度録音し、再試行してください。

• 原因： 録音ファイルの URL にアクセスできません。

  解決方法： CosyVoice ボイスクローン API の指示に従って再試行してください。

• 原因： 録音ファイルが長すぎます。

  解決方法： 10 秒から 15 秒の録音を選択するようにしてください。録音する際は、流暢に話し、少なくとも 5 秒以上の連続した発話セグメントを含めるようにしてください。

500-InternalError.FileUpload

OSS アップロードエラー。

原因： ファイルのアップロードに失敗しました。

解決方法： OSS の構成とネットワークを確認してください。

500-InternalError.Upload

結果のアップロードに失敗しました。

原因： 生成結果のアップロードに失敗しました。

解決方法： ストレージの構成を確認するか、後で再試行してください。

500-InternalError.Algo

推論内部エラー。

原因： サービス例外が発生しました。

解決方法： まずは一時的な問題ではないことを確認するために再試行してください。

',' デリミタが必要です：行 x 列 xxx (文字 xxx)

原因： モデルによって生成された JSON データが無効であり、ツール呼び出しを正常に開始できません。

解決方法： 最新のモデルに切り替えるか、プロンプトを最適化して再試行してください。

マルチモーダル URL の Content-Length が不足しています。

原因： URL リクエストのレスポンスヘッダーから Content-Length フィールドが不足しています。

解決方法： 問題が解決しない場合は、別の画像リンクを使用してみてください。

モデルサービスでエラーが発生しました。エラーメッセージは：[推論エンジンによってリクエストが拒否されました！]

原因： モデルサービスの基盤となるサーバーでエラーが発生しました。

解決方法： 後で再試行してください。

アルゴリズム実行中に内部エラーが発生しました。

原因： アルゴリズムの実行中にエラーが発生しました。

解決方法： 後で再試行してください。

推論エラー：推論エラー。

原因： 推論エラーが発生しました。

解決方法： 入力画像ファイルが破損していないか、人物画像の品質を確認してください。完全で鮮明な顔が含まれている必要があります。

Role は [user, assistant] のいずれかでなければなりません

原因： Qwen-MT モデルを使用する際、messages 配列に user 以外のロールを持つメッセージが含まれています。

解決方法： messages 配列に 1 つの要素のみが含まれており、その要素がユーザーメッセージであることを確認してください。

Embedding_pipeline_Error: xxx

原因： 画像または動画の前処理中にエラーが発生しました。

解決方法： アップロードされた画像または動画とリクエストコードが要件を満たしていることを確認し、再度試行してください。

バッチ処理バックエンドからの応答の受信に失敗しました！

原因： 内部サービスエラーが発生しました。

解決方法： 後で再試行してください。

実行中に内部エラーが発生しました。後で再試行するか、サービスサポートにお問い合わせください。/ アルゴリズム処理エラー。/ 推論エラー。/ 計算中に内部エラーが発生しました。後でこのモデルを試してください。

原因： 内部アルゴリズムエラーが発生しました。

解決方法： 後で再試行してください。

リストのインデックスが範囲外です

原因： messages 配列の最後の要素はユーザーメッセージでなければなりません。

解決方法： messages 配列の順序を調整し、最後の要素が {"role": "user", ...} であることを確認してください。

500-InternalError.Timeout

実行中に内部タイムアウトエラーが発生しました。後で再試行するか、サービスサポートにお問い合わせください。

原因： 非同期タスクの送信後、3 時間以内に結果が返されず、タイムアウトが発生しました。

解決方法： タスクの実行ステータスを確認するか、テクニカルサポートにお問い合わせください。

500-SystemError

システムエラーが発生しました。後で再試行してください。

原因： システムエラーが発生しました。

解決方法： 後で再試行してください。

500-ModelServiceFailed

モデルサービスへのリクエストに失敗しました。

原因： モデルサービスの呼び出しに失敗しました。

解決方法： 後で再試行してください。

500-RequestTimeOut

リクエストがタイムアウトしました。後で再試行してください。/ 応答タイムアウト！/ "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" への POST リクエストで I/O エラー：タイムアウト

原因：

• 言語モデルを使用する際、リクエストがタイムアウトしました。タイムアウトエラー時間は 300 秒です。

• 音声認識（Paraformer）を使用する際、長時間サーバーに音声が送信されなかったか、長時間無音の音声が送信されました。

• 画像生成または編集モデルを使用する際、画像サイズが大きい、または処理の複雑度が高いことにより、処理時間が制限を超過しました。

解決方法：

• 言語モデルの場合、ストリーミング出力を使用してリクエストを送信してください。詳細については、「ストリーミング出力」をご参照ください。

• Paraformer の場合、リクエストパラメーター heartbeat を true に設定するか、認識タスクを速やかに終了してください。

• 画像モデルの場合、画像解像度を下げたり、編集要件を簡素化したり、後でリクエストを再試行したりしてください。

500-InvokePluginFailed

プラグインの呼び出しに失敗しました。

原因： プラグインの呼び出しに失敗しました。

解決方法： プラグインの構成と可用性を確認してください。

500-AppProcessFailed

アプリケーションリクエストの処理に失敗しました。

原因： アプリケーションフローの処理に失敗しました。

解決方法： アプリケーションの構成とフローノードを確認してください。

500-RewriteFailed

プロンプトのコンテンツの書き換えに失敗しました。

原因： プロンプトリライトモデルの呼び出しに失敗しました。

解決方法： 後で再試行してください。

500-RetrievalFailed

ドキュメントからのデータ取得に失敗しました。

原因： ドキュメントの取得に失敗しました。

解決方法： ドキュメントのインデックスと取得構成を確認してください。

500/503-ModelServingError

リクエストが多すぎます。システム容量制限により、リクエストが速度制限されています。後で再試行してください。

原因： ネットワークリソースが現在飽和状態であり、リクエストを処理できません。

解決方法： 後で再試行してください。

503-ModelUnavailable

モデルが利用できません。後で再試行してください。

原因： モデルが一時的に利用できません。

解決方法： 後で再試行してください。

SDK errors

error.AuthenticationError: API キーが提供されていません。コード内で dashscope.api_key = your_api_key を設定するか、環境変数 DASHSCOPE_API_KEY= your_api_key を設定できます。

原因： DashScope SDK を使用する際に API キーが提供されていませんでした。

解決方法： API キーの設定方法については、「API キーを環境変数として設定する」をご参照ください。

openai.OpenAIError: api_key クライアントオプションは、api_key をクライアントに渡すか、OPENAI_API_KEY 環境変数を設定することで設定する必要があります

原因： API キーが渡されていませんでした。

解決方法：

• 環境変数を使用して API キーを渡す（推奨）

  DASHSCOPE_API_KEY 環境変数を設定し（「API キーを環境変数として設定する」をご参照ください）、client を初期化する際に os.getenv メソッドを使用してキーを読み取ります：

  client = OpenAI(api_key=os.getenv("DASHSCOPE_API_KEY"),...)

• API キーをプレーンテキストで渡す（テスト目的のみ）

  api_key パラメーターに API キーを直接渡します：

  client = OpenAI(api_key="sk-...", ...)

  注： この方法はセキュリティリスクを伴います。本番環境では使用しないでください。

URL の不正なリクエスト： xxx

原因： Python の requests ライブラリを使用する際、response.raise_for_status() ステートメントを追加すると、エラー発生時にサーバーからの特定のエラーコンテンツが返されなくなります。

解決方法： print(response.json()) を使用して、サーバーから返された情報を表示してください。

シンボル 'ttsv2' を解決できません

原因： 音声合成（CosyVoice） を使用している場合、この問題は DashScope SDK のバージョンが古いために発生します。

解決方法： DashScope SDK の最新バージョンをインストール してください。

NetworkError

NoApiKeyException: API キーが見つかりません。

原因： 環境変数が有効になっていません。

解決方法： クライアントまたは IDE を再起動して再試行してください。詳細については、「よくある質問」をご参照ください。

ConnectException: dashscope.aliyuncs.com への接続に失敗しました

原因： オンプレミスネットワーク環境に例外が存在します。

解決方法： オンプレミスネットワークを確認してください。例えば、証明書の問題により HTTPS にアクセスできない、またはファイアウォールが正しく設定されていない可能性があります。別のネットワーク環境またはサーバーに切り替えてテストすることを推奨します。

InputRequiredException: パラメーターが無効です：text が null です

原因： 音声合成（CosyVoice） を使用する際、合成するテキストが送信されませんでした。

解決方法： 音声合成 API を呼び出す際に、text パラメーターに値を割り当ててください。

MultiModalConversation.call() に必須の位置引数 'messages' が 1 つ不足しています

原因： DashScope SDK のバージョンが古いです。

解決方法： DashScope SDK の最新バージョンをインストール してください。

mismatched_model

このリクエストのモデル 'xxx' は、バッチの残りの部分と一致しません。各バッチには、単一のモデルに対するリクエストが含まれている必要があります。

原因： 単一のバッチタスクでは、すべてのリクエストが同じモデルを使用する必要があります。

解決方法： 入力ファイル形式 に従って入力ファイルを確認してください。

duplicate_custom_id

このリクエストの custom_id 'xxx' は、別のリクエストと重複しています。custom_id パラメーターは、バッチ内の各リクエストで一意である必要があります。

原因： 単一のバッチタスクでは、各リクエストの ID は一意である必要があります。

解決方法： 入力ファイル形式 に従って入力ファイルを確認し、すべてのリクエスト ID が一意であることを確認してください。

アップロードファイル容量が制限を超過しました。/ アップロードファイル数が制限を超過しました。

原因： ファイルのアップロードに失敗しました。現在の Alibaba Cloud アカウント下の Model Studio ストレージスペースが満杯であるか、ほぼ満杯です。

解決方法： OpenAI 互換 - ファイル API を使用して不要なファイルを削除し、スペースを解放できます。現在のストレージスペースは、最大 10,000 ファイル、合計 100 GB までをサポートしています。

WebSocket errors

デコードされたテキストメッセージが出力バッファに対して大きすぎ、エンドポイントは部分的なメッセージをサポートしていません

原因： 音声認識（Paraformer） を使用したストリーミング音声認識を行う際、サービスから返される認識結果データ量が大きすぎます。

解決方法： 認識対象の音声をセグメントに分けて送信してください。1 回に送信する音声の持続時間は約 100 ミリ秒、データサイズは 1 KB から 16 KB の間に保つことを推奨します。

TimeoutError: WebSocket 接続が 5 秒以内に確立できませんでした。ネットワーク接続、ファイアウォール設定、またはサーバーの状態を確認してください。

原因： 音声合成（CosyVoice）を使用している場合、WebSocket 接続が 5 秒以内に確立できませんでした。

解決方法： オンプレミスネットワークとファイアウォール設定を確認するか、別のネットワーク環境またはサーバーに切り替えてテストしてください。

サポートされていない音声フォーマット：xxx

原因： CosyVoice ボイスクローンを実行する際、アップロードされた音声フォーマットがモデルの要件を満たしていません。

解決方法： 音声フォーマットは WAV (16-bit)、MP3、または M4A である必要があります。ファイル名拡張子だけでフォーマットを判断できないことに注意してください。ffprobe や mediainfo などのツール、または Linux/macOS の file コマンドを使用して、音声ファイルの実際のエンコード形式を確認することを推奨します。

内部不明エラー

原因： CosyVoice ボイスクローン音声ファイルのフォーマットが要件を満たしていない可能性があります。

解決方法： 音声フォーマットは WAV (16-bit)、MP3、または M4A である必要があります。ffprobe や mediainfo などのツールを使用して、音声ファイルの実際のエンコード形式を確認することを推奨します。

無効なバックエンド応答を受信しました（ステータス名が不足しています）

原因： 音声認識（Paraformer）の RESTful API を使用して音声ファイル認識を行う際、リクエストパラメーターのスペルが間違っています。

解決方法： API リファレンスを参照してコードを確認してください。

NO_INPUT_AUDIO_ERROR

原因： 有効な音声が検出されませんでした。

解決方法： 音声認識（Paraformer）を使用したリアルタイム音声認識を行う場合、以下のトラブルシューティングを行ってください：

1. 音声入力があるかを確認してください。

2. 音声フォーマットが正しいかを確認してください。pcm、wav、mp3、opus、speex、aac、amr がサポートされています。

SUCCESS_WITH_NO_VALID_FRAGMENT

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識結果クエリ API は正常に呼び出されましたが、VAD モジュールが有効な音声を検出しませんでした。

解決方法： 音声ファイルに有効な音声が含まれているかを確認してください。純粋な無音など、すべてが無効な音声である場合、認識結果がないのは正常です。

ASR_RESPONSE_HAVE_NO_WORDS

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識結果クエリ API は正常に呼び出されましたが、最終的な認識結果が空です。

解決方法： 音声ファイルに有効な音声が含まれているか、または有効な音声がすべてフィラーワードであり、非流暢性検出パラメーター disfluency_removal_enabled が有効になっているためにフィラーワードがフィルタリングされているかを確認してください。

FILE_DOWNLOAD_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識対象のファイルのダウンロードに失敗しました。

解決方法： 音声ファイルのパスが正しいこと、および外部ネットワークからアクセスしてダウンロードできることを確認してください。

FILE_CHECK_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、ファイル形式が不正です。

解決方法： 音声ファイルがシングル/デュアルトラック WAV 形式または MP3 形式であることを確認してください。

FILE_TOO_LARGE

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識対象のファイルが大きすぎます。

解決方法： 音声ファイルサイズが 2 GB を超えているかを確認してください。超えている場合は、音声ファイルをセグメントに分割する必要があります。

FILE_NORMALIZE_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識対象のファイルの正規化に失敗しました。

解決方法： 音声ファイルが破損していないか、正常に再生できるかを確認してください。

FILE_PARSE_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、ファイルの解析に失敗しました。

解決方法： 音声ファイルが破損していないか、正常に再生できるかを確認してください。

MKV_PARSE_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、MKV の解析に失敗しました。

解決方法： 音声ファイルが破損していないか、正常に再生できるかを確認してください。

FILE_TRANS_TASK_EXPIRED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、音声ファイル認識タスクの有効期限が切れました。

解決方法： TaskId が存在しないか、有効期限が切れています。タスクを再送信してください。

REQUEST_INVALID_FILE_URL_VALUE

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、リクエストの file_link パラメーターが無効です。

解決方法： file_url パラメーターの形式が正しいことを確認してください。

CONTENT_LENGTH_CHECK_FAILED

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、content-length チェックに失敗しました。

解決方法： 認識対象の音声ファイルをダウンロードする際、HTTP レスポンスの content-length が実際のファイルサイズと一致しているかを確認してください。

FILE_404_NOT_FOUND

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、ダウンロード対象のファイルが存在しません。

解決方法： ファイル URL が正しいことを確認してください。

FILE_403_FORBIDDEN

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、認識対象の音声をダウンロードする権限がありません。

解決方法： ファイルのアクセス権限を確認してください。

FILE_SERVER_ERROR

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、リクエストされたファイルが配置されているサービスが利用できません。

解決方法： 後で再試行するか、ファイルサーバーの状態を確認してください。

AUDIO_DURATION_TOO_LONG

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、リクエストされたファイルの持続時間が 12 時間を超えています。

解決方法： 音声をセグメントに分割し、認識タスクを複数回送信することを推奨します。FFmpeg などのツールを使用して音声をセグメントに分割できます。

DECODE_ERROR

原因： 音声認識（Paraformer）を使用した音声ファイル認識を行う際、音声ファイル情報の検出に失敗しました。

解決方法： ファイルダウンロードリンク内のファイルがサポートされている音声フォーマットであることを確認してください。

CLIENT_ERROR-[qwen-tts:]エンジンがエラーコード：411 を返しました

原因： Qwen-TTS リアルタイム音声合成を実行する際、選択されたモデルが qwen-tts-vc-realtime-2025-08-20 であるにもかかわらず、ボイスがデフォルトボイスです。このモデルはクローンされたボイスのみをサポートしています。

解決方法： デフォルトボイスではなく、ボイスクローンによって生成されたボイスを使用してください。

NO_VALID_AUDIO_ERROR

原因： 音声認識（Paraformer） を使用する際、認識対象の音声が無効です。解決方法： 音声フォーマット、サンプルレート、その他のパラメーターが要件を満たしているかを確認してください。

InvalidParameter: task は null であってはなりません

原因： CosyVoice 音声合成 WebSocket API を使用する際、run-task または finish-task 命令のペイロードから input フィールドが不足しているか、continue-task 命令から input.text フィールドが不足しています。

解決方法：

1. run-task 命令を確認してください：ペイロードに "input": {}（null オブジェクト）が含まれていることを確認してください。input フィールドは必須です。

2. continue-task 命令を確認してください：payload.input に text フィールドが含まれており、その値が空文字列ではないことを確認してください。

3. finish-task 命令を確認してください：ペイロードに "input": {} が含まれていることを確認してください。

200-BailianGateway.Workspace.NotAuthorised

原因： アクセスされた URL に特殊文字が含まれているか、非標準形式を使用しているため、ワークスペースの権限検証に失敗しました。

解決方法： Model Studio コンソールのホームページに戻り、目的のページに移動してください。