エラーコード - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

このトピックでは、Alibaba Cloud Model Studio の使用中に発生する可能性のある一般的なエラーメッセージとその解決策について説明します。

400-無効パラメーター

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

原因：思考モードのモデルを、ストリーミング以外の出力方法で呼び出しました。

解決策：enable_thinking パラメーターを false に設定するか、ストリーミング出力方式を使用して思考モードのモデルを呼び出します。

The thinking_budget parameter must be a positive integer and not greater than xxx

原因：thinking_budget パラメーターが許容範囲外です。

解決策：モデルリストに記載されているモデルの最大 Chain-of-Thought 長を参照し、このパラメーターを 0 より大きく、その上限以下の値に設定します。

This model only support stream mode, please enable the stream parameter to access the model. / current user api does not support http call.

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

解決策：ストリーミング出力方式を使用してモデルを呼び出します。

This model does not support enable_search.

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

解決策：Web 検索をサポートするモデルを呼び出します。

Current language settings are not supported!

原因：Qwen-MT モデルの使用時に、source_lang または target_lang のフォーマットが正しくないか、サポートされている言語に含まれていません。

解決策：正しい英語名または言語コードを指定します。

The incremental_output parameter must be "true" when enable_thinking is true

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

解決策：呼び出し前に incremental_output パラメーターを true に設定します。API は増分コンテンツを返します。

The incremental_output parameter of this model cannot be set to False.

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

解決策：呼び出し前に incremental_output パラメーターを true に設定します。API は増分コンテンツを返します。

入力長は [1, xxx] の範囲内である必要があります

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

解決策：

コード経由で呼び出す場合、messages 配列の合計トークン数がモデルの最大入力トークン制限内に収まるようにします。
チャットクライアント (Chatbox など) や Alibaba Cloud Model Studio コンソールを使用して連続した会話を行う場合、各リクエストには会話履歴が含まれるため、モデルの制限を簡単に超える可能性があります。この場合は、新しい会話を開始します。

max_tokens の範囲は [1, xxx] である必要があります

原因：max_tokens パラメーターが [1, モデルの最大出力トークン数] の範囲内にありません。

解決策：モデルリストのドキュメントにある「最大出力トークン数」の値を参照して、max_tokens の上限を確認します。

Temperature should be in [0.0, 2.0)/'temperature' must be Float

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

解決策：temperature パラメーターを 0 以上 2 未満の数値に設定します。

Range of top_p should be (0.0, 1.0]/'top_p' must be Float

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

解決策：top_p パラメーターを 0 より大きく 1 以下の数値に設定します。

Parameter top_k be greater than or equal to 0

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

解決策：top_k パラメーターを 0 以上の数値に設定します。

Repetition_penalty should be greater than 0.0

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

解決策：repetition_penalty パラメーターを 0 より大きい数値に設定します。

Presence_penalty should be in [-2.0, 2.0]

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

解決策：presence_penalty パラメーターを [-2.0,2.0] の範囲内に設定します。

Range of n should be [1, 4]

原因：n パラメーターが [1, 4] の範囲内にありません。

解決策：n パラメーターを [1, 4] の範囲内に設定します。

Range of seed should be [0, 9223372036854775807]

原因：DashScope プロトコルを使用する場合、seed パラメーターが [0, 9223372036854775807] の範囲内にありません。

解決策：seed パラメーターを [0, 9223372036854775807] の範囲内に設定します。

Request method 'GET' is not supported.

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

解決策：API リファレンスを参照し、サポートされているリクエストメソッド (例：POST) を使用してリクエストを再送信します。

ロールが "tool" のメッセージは、"tool_calls" を持つ先行するメッセージへの応答でなければなりません

原因：ツール呼び出し中に、Assistant Message を messages 配列に追加しませんでした。

解決策：Tool Message を追加する前に、モデルの最初の Assistant Message 応答を messages 配列に追加します。

リクエストボディが無効です。リクエストボディのフォーマットを確認してください。

原因：リクエストボディのフォーマットが API の要件を満たしていません。

解決策：リクエストボディが有効な JSON であることを確認します。一般的な問題には、末尾のカンマ (,) や閉じられていない括弧などがあります。大規模モデルを使用してリクエストボディのフォーマットを修正できます。

input content must be a string.

原因：プレーンテキストモデルは、messages の content フィールドを文字列以外の型に設定することをサポートしていません。

解決策：content を [{"type": "text","text": "Who are you?"}] のような配列型に設定しないでください。

The content field is a required field.

原因：リクエストを行う際に、content パラメーターを指定しませんでした (例：{"role": "user"})。

解決策：content パラメーターを指定します (例：{"role": "user","content": "Who are you?"})。

Either "prompt" or "messages" must exist and cannot both be none

原因：大規模言語モデルを呼び出す際に、messages パラメーターも prompt パラメーター (非推奨) も指定しませんでした。messages を指定してもエラーが発生する場合、フォーマットが間違っている可能性があります。例えば、DashScope-HTTP を使用する場合、messages は model パラメーターと同じレベルではなく、input オブジェクト内に配置する必要があります。

解決策：messages パラメーターを指定します。それでもエラーが発生する場合は、テキスト生成 API リファレンスを参照して、その配置を確認します。

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

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

解決策：プロンプトにキーワード json (大文字と小文字を区別しない) を追加します (例：「JSON 形式で出力してください」)。

Json mode response is not supported when enable_thinking is true

原因：構造化出力を使用しながら、モデルの思考モードを有効にしました。

解決策：構造化出力を使用する場合は、enable_thinking を false に設定して思考モードを無効にします。または、よくある質問「思考モードのモデルで構造化出力を使用するには？」をご参照ください。

Tool names are not allowed to be [search]

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

解決策：ツール名を search 以外の値に設定します。

Unknown format of response_format, response_format should be a dict, includes 'type' and an optional key 'json_schema'. The response_format type from user is xxx.

原因：指定された response_format パラメーターが要件に準拠していません。

解決策：構造化出力を使用するには、response_format パラメーターを {"type": "json_object"} に設定します。

The value of the enable_thinking parameter is restricted to True.

原因：特定のモデル (例：qwen3-235b-a22b-thinking-2507) では、enable_thinking パラメーターを false に設定することはできません。

解決策：

サードパーティツール (Cherry Studio など) を介して呼び出す場合は、入力ボックスの思考トグルを有効にします。
コード経由で呼び出す場合は、enable_thinking を true に設定します。

'audio' output only support with stream=true

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

解決策：stream パラメーターを true に設定してストリーミング出力を有効にします。

tool_choice is one of the strings that should be ["none", "auto"]

原因：ファンクションコール中の tool_choice パラメーターが正しくありません。

解決策：「auto」(LLM が自律的にツールを選択) または「none」(ツールの使用を強制的に禁止) に設定します。

モデルが存在しません。

原因：model パラメーターが無効であるか、フォーマットが正しくありません。

解決策：

モデル名のフォーマットを確認する：model パラメーターが正しい大文字と小文字を使用しており、余分なスペースが含まれていないことを確認します。
正しいモデル名を使用する: 入力した model をモデルリストのモデル名と照合し、正しいことを確認してください。qwen3-235b-a22b-instruct-2507 の代わりに Qwen/Qwen3-235B-A22B-Instruct-2507 を使用するなど、オープンソースコミュニティのモデル名と Model Studio のモデル ID を混同しないでください。

The result_format parameter must be "message" when enable_thinking is true

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

解決策：result_format パラメーターを "message" に設定します。

The audio is empty

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

解決策：音声の長さを増やします。

File parsing in progress, please try again later.

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

解決策：ファイルの解析が完了するのを待ってから再試行します。

The "stop" parameter must be of type "str", "list[str]", "list[int]", or "list[list[int]]", and all elements within the list must be of the same type.

原因：stop パラメーターが、必要なフォーマット (str、list[str]、list[int]、または list[list[int]]) に準拠していません。

解決策：テキスト生成 API リファレンスを参照し、stop パラメーターを正しく設定します。

Value error, batch size is invalid, it should not be larger than xxx.

原因：Embedding モデルを呼び出す際に、テキストの数がモデルの制限を超えています。

解決策：Embedding ドキュメントのバッチサイズ情報を参照し、入力テキストの数を制御します。

[] は短すぎます

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

解決策：リクエストを送信する前にメッセージを追加します。

The tool call is not supported.

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

解決策：ファンクションコールをサポートする Qwen または DeepSeek モデルに切り替えます。

Repetitive tool calls detected in the conversation history. The same tool call with identical name and arguments has been repeated across multiple consecutive rounds. Please modify your request or adjust the tool call arguments to avoid infinite loops.

原因：会話履歴で反復的なツール呼び出しが検出されました。同じ名前と引数を持つツール呼び出しが複数回連続して繰り返されており、モデルが無限ループに陥っている可能性があります。HTTP ステータスコードは 400、エラーコードは InternalError.Algo.InvalidParameter です。

解決策：

各ラウンドのツール呼び出しの後、ツール実行結果を Tool Message として messages 配列に追加してから次のリクエストを送信し、モデルが結果に基づいて処理を進められるようにします。
ツールが結果を正しく返すかどうかを確認します。ツールが同じまたは無効な結果を返し続ける場合は、アプリケーション側で最大呼び出し制限または終了ロジックを追加して無限ループを回避します。
必要に応じて、プロンプトを修正してタスク完了条件を明確に定義し、モデルが同じツール呼び出しを繰り返し発行するのを防ぎます。

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

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

解決策：リクエストパラメーターを確認し、すべての必須パラメーターが提供され、正しくフォーマットされていることを確認します。

エラーメッセージがパラメーター data_sources を指定している場合、通常は CreateIndex API を呼び出す際に必須パラメーター SourceType が省略されたため、後続の SubmitIndexJob API が失敗したことを意味します。ドキュメントからナレッジベースを作成する場合は、このパラメーターを DATA_CENTER_FILE に設定し、カテゴリから作成する場合は DATA_CENTER_CATEGORY に設定します。詳細については、CreateIndex のドキュメントをご参照ください。

input must contain file_urls

原因：音声認識 (Paraformer) を使用して録音ファイルを認識する際に、file_urls リクエストパラメーターに値を割り当てませんでした。

解決策：リクエストに file_urls パラメーターを含め、値を割り当てます。

The provided URL does not appear to be valid. Ensure it is correctly formatted.

原因：視覚理解、オムニモーダル、または音声理解モデルを使用する際に、指定された URL またはローカルパスが無効であるか、要件を満たしていません。

解決策：

URL を渡す場合：http://、https://、または data: で始まる必要があります。data: で始まる場合は、Base64 エンコードされたデータの前に "base64" を含めます。
ローカルパスを渡す場合：file:// で始まる必要があります。
一時 URL を渡す場合：
- HTTP 呼び出しの場合、リクエストヘッダーに X-DashScope-OssResourceResolve: enable が含まれていることを確認します。
- SDK 呼び出しの場合：DashScope SDK のみがサポートされています。OpenAI SDK は使用しないでください。

Input should be a valid dictionary or instance of GPT3Message

原因：messages フィールドのフォーマットが無効です。例えば、括弧の不一致やキーと値のペアの欠落などがあります。

解決策：messages フィールドの JSON 構造が正しいことを確認します。

値エラー、contents が str または str のリストではありません。: input.contents

原因：Embedding モデルを使用する際に、入力が文字列でも文字列のリストでもありません。

解決策：入力フォーマットを文字列または文字列のリストに変更します。

The video modality input does not meet the requirements because: the range of sequence images shoule be (4, 512)./(4,80).

原因：Qwen VL モデルを使用してビデオを画像のリストとして入力する場合、画像の数が要件を満たしていません。

解決策：Qwen3-VL および Qwen2.5-VL シリーズのモデルでは 4～512 枚の画像、その他のモデルでは 4～80 枚の画像を指定します。詳細については、「画像とビデオの理解」をご参照ください。

Exceeded limit on max bytes per data-uri item : 10485760'. / Multimodal file size is too large

原因：マルチモーダルモデル (Qwen-VL、QVQ、Qwen-Omni) に渡されたローカルの画像またはビデオファイルがサイズ制限を超えています。

解決策：

ローカルファイル：Base64 エンコード後、1 つのファイルは 10 MB を超えてはなりません。
ファイル URL：画像ファイルは 10 MB を超えてはなりません。ビデオファイルの場合：
- Qwen3-VL、qwen-vl-max：最大 2 GB
- qwen-vl-plus シリーズ：最大 1 GB
- その他のモデル：最大 150 MB

「画像やビデオをサイズ要件に合わせて圧縮するには？

Input should be 'Cherry', 'Serena', 'Ethan' or 'Chelsie': parameters.audio.voice

原因：Qwen-Omni または Qwen-TTS を使用する際に、voice パラメーターが正しくありません。

解決策：'Cherry'、'Serena'、'Ethan'、または 'Chelsie' のいずれかに設定します。

The image length and width do not meet the model restrictions.

原因：Qwen VL モデルに渡された画像の寸法 (幅と高さ) がモデルの要件を満たしていません。

解決策：画像の寸法は、幅と高さがともに 10 ピクセル以上であり、アスペクト比が 200:1 または 1:200 を超えないことを満たす必要があります。

Failed to decode the image during the data inspection.

原因：画像デコードに失敗しました。

解決策：画像が破損しておらず、そのフォーマットがサポートされていることを確認します。

The file format is illegal and cannot be opened. / The audio format is illegal and cannot be opened. / The media format is not supported or incorrect for the data inspection.

原因：ファイル形式がサポートされていないか、ファイルを開けません。

解決策：ファイルが破損していないこと、ファイル名拡張子が実際のフォーマットと一致していること、およびフォーマットがサポートされていることを確認します。

The input messages do not contain elements with the role of user.

原因：

モデルを呼び出す際に、User Message を渡さなかった。
または、API を介して Alibaba Cloud Model Studio ワークフローアプリケーションを呼び出す場合、開始ノードに渡されるパラメーターは biz_params パラメーターを介して送信する必要があります (user_prompt_params ではありません)。

解決策：モデルに User Message を渡すか、カスタムパラメーターを正しく渡すようにします。

Failed to download multimodal content. / Download the media resource timed out during the data inspection process. / Unable to download the media resource during the data inspection process.

原因：サーバーがパブリック URL からメディアファイルをダウンロードできません。考えられる原因は次のとおりです：

接続の問題：Alibaba Cloud Object Storage Service からの内部ネットワークアドレスを使用している。
ネットワーク遅延：クロスリージョンアクセスによるタイムアウト。
サービスの不安定性：ソースストレージサービスが遅い、または到達不能。

解決策：

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

モデルサービスと同じリージョンのストレージサービスを使用します。Alibaba Cloud Object Storage Service を使用してパブリック URL を生成することを推奨します (内部アドレスは使用しないでください)。

転送方法の調整

パブリック URL の受け渡しに失敗した場合は、「ローカルファイル (Base64 エンコードまたはファイルパス) を渡す」を参照し、推奨される方法に切り替えます：

ファイルタイプ	ファイル仕様	DashScope SDK (Python, Java)	OpenAI 互換 / DashScope HTTP
画像	7 MB より大きく 10 MB 未満	ローカルパスを渡す	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します
画像	7 MB 未満	ローカルパスを渡す	Base64 エンコード
ビデオ	100 MB より大きい	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します
	7 MB より大きく 100 MB 未満	ローカルパスを渡す	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します
	7 MB 未満	ローカルパスを渡す	Base64 エンコード
音声	10 MB より大きい	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します
	7 MB より大きく 10 MB 未満	ローカルパスを渡す	パブリック URL のみ。Alibaba Cloud Object Storage Service の使用を推奨します
	7 MB 未満	ローカルパスを渡す	Base64 エンコード

Base64 エンコーディングはデータサイズを増加させます。元のファイルは 7 MB 未満である必要があります。

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

Failed to find the requested media resource during the data inspection process.

原因：指定されたリソース URL が無効であるか、アクセスできません。

解決策：

URL が正しくフォーマットされ、アクセス可能であることを確認します。
リソースファイルが削除または移動されていないことを確認します。
URL が期限切れでないことを確認します (OSS 署名付き URL の場合、有効期間を確認します)。

url error, please check url！

原因 1：モデル名が API エンドポイントと一致しない：例えば、プレーンテキストモデルにマルチモーダルエンドポイントを使用したり、マルチモーダルモデルにプレーンテキストエンドポイントを使用したりする場合。

解決策：
1. DashScope を介して qwen3.7-plus や qwen3-vl-plus などのマルチモーダルモデルを使用する場合：MultiModalConversation.call() または multimodal-generation エンドポイントを使用します。「画像とビデオの理解」をご参照ください。
  
  spring-ai-alibaba フレームワークを使用している場合は、マルチモーダルパラメーター withMultiModel を設定していることを確認してください。
2. DashScope を介して qwen3-max、qwen-plus、deepseek-v4-pro などのプレーンテキストモデルを使用する場合、Generation.call() または text-generation エンドポイントを使用します。「概要」をご参照ください。
3. DashScope を介して CosyVoice 音声クローニング API を使用する場合：この API には model と target_model パラメーターが含まれます。model を voice-enrollment に、target_model を特定の CosyVoice モデルに設定します。「CosyVoice 音声クローニング/デザイン API」をご参照ください。
原因 2：DashScope SDK のバージョンが古い：古い SDK バージョンでは、画像/ビデオ生成モデルを呼び出す際に正しいサーバーアドレスを認識できません。

解決策：SDK のバージョンをアップグレードする

Don't have authorization to access the media resource during the data inspection process.

原因：モデル呼び出し中に渡された署名付き OSS ファイル URL が期限切れです。

解決策：URL の有効期間内にファイルにアクセスするようにします。

The item of content should be a message of a certain modal.

原因：DashScope SDK を使用してマルチモーダルモデルを呼び出す場合、content 配列の各要素には、image、video、audio、または text のいずれかであるキーが必要です。

解決策：正しい content パラメーターを使用します。

Invalid video file.

原因：指定されたビデオファイルが無効です。

解決策：ビデオファイルが破損していないか、フォーマットが正しいかを確認します。

The video modality input does not meet the requirements because: The video file is too long.

原因：ビデオの長さが Qwen VL または Qwen-Omni モデルの制限を超えています。

解決策：

Qwen2.5-VL は 2 秒から 10 分のビデオをサポートします。
その他の Qwen VL または Qwen-Omni モデルは 2 秒から 40 秒のビデオをサポートします。

Field required: xxx

原因：必須の入力パラメーターが欠落しています。

解決策：エラーメッセージ xxx で示される欠落しているパラメーターを追加します。

The request is missing required parameters or in a wrong format, please check the parameters that you send.

原因：必須パラメーターが欠落しているか、フォーマットが正しくありません。

解決策：すべてのリクエストパラメーターが完全で、正しくフォーマットされていることを確認します。

Invalid ext_bbox.

原因：入力された ext_bbox が無効です。

解決策：詳細については、「絵文字ビデオ生成」をご参照ください。

Driven not exist: driven_id.

原因：入力された driven_id が存在しません。

解決策：詳細については、「絵文字ビデオ生成」をご参照ください。

Missing training files.

原因：パラメーターエラー — パラメーターの欠落または不正なフォーマット。

The style is invalid.

原因：style の値が許可された列挙の範囲外です。

解決策：style パラメーターの値が正しいことを確認します。

The style_level is invalid.

原因：style_level の値が許可された列挙の範囲外です。

解決策：詳細については、「EMO ビデオ生成」をご参照ください。

parameters.video_ratio must be 9:16 or 3:4.

原因：video_ratio パラメーターは 9:16 または 3:4 のみ可能です。

解決策：video_ratio パラメーターを "9:16" または "3:4" に設定します。

the xxx parm is invalid!

原因：入力パラメーターが許可範囲を超えています。

解決策：詳細については、「ビデオスタイル再描画」をご参照ください。

input json error.

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

解決策：リクエストの JSON フォーマットが正しいことを確認します。

read image error.

原因：画像の読み取りに失敗しました。

解決策：画像ファイルが破損していないか、フォーマットが正しいかを確認します。

the parameters must conform to the specification: xxx.

原因：入力パラメーターの値が許可範囲を超えています。

解決策：エラーメッセージ xxx で示されるパラメーターの値を確認し、修正します。

The size of person image and coarse_image are not the same.

原因：coarse_image の解像度が person_image と一致しません。

解決策：coarse_image と person_image の解像度が同一であることを確認します。

The request is missing required parameters or the parameters are out of the specified range, please check the parameters that you send.

原因：必須の API パラメーターが欠落しているか、範囲外です。

解決策：リクエストパラメーターを確認し、修正します。

image format error

原因：画像フォーマットが正しくありません。

解決策：画像 URL または Base64 文字列である必要があります。

No messages found in input

原因：リクエストパラメーターには messages フィールドが含まれている必要があります。

解決策：詳細については、「Qwen - 画像編集」をご参照ください。

Invalid image format or corrupted file

原因：入力画像のフォーマットが正しくないか、ファイルが破損しています。

解決策：ファイルが正常に開けてダウンロードできることを確認し、完全でサポートされているフォーマットであることを確認します。

download image failed

原因：画像をダウンロードできません。

解決策：ファイルが正常にダウンロードできることを確認します。

messages length only support 1

原因：messages 配列の長さは 1 のみをサポートします。

解決策：渡せる会話メッセージは 1 つだけです。詳細については、「Qwen - 画像編集」をご参照ください。

content length only support 2

原因：content 配列の長さは 2 のみをサポートします。

解決策：渡せるのはテキスト 1 つと画像 1 つだけです。詳細については、「Qwen - 画像編集」をご参照ください。

lack of image or text

原因：リクエストパラメーターに画像またはテキストフィールドがありません。

解決策：詳細については、「Qwen - 画像編集」をご参照ください。

num_images_per_prompt must be 1.

原因：リクエストパラメーターが無効です。パラメーター n (生成する画像の数) は 1 にしか設定できません。

解決策：パラメーター n の値を 1 に設定します。

Input files format not supported.

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

解決策：サポートされている音声フォーマット：mp3、wav、aac。サポートされている画像フォーマット：jpg、jpeg、png、bmp、webp。詳細については、「LivePortrait ビデオ生成」をご参照ください。

Failed to download input files.

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

解決策：ファイル URL がアクセス可能で、ネットワークが安定していることを確認します。

oss download error.

原因：入力画像のダウンロードに失敗しました。

解決策：画像の OSS リンクが正しく、アクセス可能であることを確認します。

The image content does not comply with green network verification.

原因：画像コンテンツがコンプライアンスポリシーに違反しています。

解決策：Content Moderation ポリシーに準拠した画像に置き換えます。

read video error.

原因：ビデオの読み取りに失敗しました。

解決策：ビデオファイルが破損していないか、フォーマットがサポートされていないかを確認します。

the size of input image is too small or too large.

原因：入力画像の寸法が小さすぎるか、大きすぎます。

解決策：API の要件を満たすように画像の寸法を調整します。

The request parameter is invalid, please check the request parameter.

原因：clothes_type パラメーターが非準拠です。

解決策：詳細については、「OutfitAnyone - 画像セグメンテーション」をご参照ください。

The type or value of {parameter} is out of definition.

原因：パラメーターの型または値が要件を満たしていません。

解決策：詳細については、「LivePortrait ビデオ生成」をご参照ください。

The request parameter is invalid, please check the request parameter.

原因：アスペクト比パラメーターが非準拠です。

解決策：有効なオプションは "1:1" または "3:4" です。

request timeout after 23 seconds.

原因：23 秒以上サービスにデータが送信されませんでした。このエラーは、音声認識 (Paraformer)、およびリアルタイム音声合成 (CosyVoice) を使用している場合に発生します。

解決策：長期間サーバーにデータが送信されなかった原因を確認します。23 秒以上サーバーにメッセージが送信されない場合は、タスクを速やかに終了します。

Please ensure input text is valid.

原因：リアルタイム音声合成 (CosyVoice) を使用している場合、このエラーは通常、合成するテキストが送信されなかったために発生します。考えられる原因は次のとおりです：パラメーターの欠落 (text パラメーターに値が割り当てられていない) またはコードの例外 (text への割り当てに失敗)。

解決策：コードをデバッグして、text パラメーターが正しく割り当てられ、送信されていることを確認します。

Missing required parameter 'xxx'! Please follow the protocol!

エラー例：

Missing required parameter 'payload.model'! Please follow the protocol!
Missing required parameter 'payload.task_group'! Please follow the protocol!

原因：

WebSocket イベントの JSON フォーマットが正しくない (一般的な原因)。

WebSocket プロトコルを使用してモデルを呼び出す際に、送信された JSON フォーマットが無効です。一般的な問題は次のとおりです：
- JSON のネストが正しくない — パラメーターが正しい階層レベルに配置されていない。
- パラメーター名のスペルミス — 例えば、task_group が taskgroup と書かれている。
- パラメーターの値が空であるか、正しく割り当てられていない。
stop() の後に call() メソッドが再呼び出しされていない (特定のシナリオ)。

これは、Fun-ASR または Paraformer のリアルタイム音声認識用の DashScope Java SDK にのみ適用されます。

stop() メソッドを呼び出して認識を終了した後、さらにデータを送信する前に call() メソッドを再呼び出ししなかったため、無効なセッション状態となり、このエラーがトリガーされました。

SDK ユーザーと WebSocket ユーザーの違い：「Missing required parameter」はサーバーから返されるプロトコルレベルのエラーであり、WebSocket プロトコルを直接使用する場合にのみ表示されます。DashScope Java SDK の Recognition クラスを使用する場合、SDK はクライアント側でこの操作をインターセプトし、「Missing required parameter」エラーを返す代わりに「Invalid state」例外 (「Expected recognition state should be started, but current state is idle」) をスローします。

解決策：

原因 1 の場合、JSON フォーマットとパラメーターを確認します。
原因 2 の場合、stop() を呼び出すたびに、次の認識ラウンドの前に call() メソッドを再呼び出しするようにします。DashScope Java SDK を使用している場合は、クライアント側の「Invalid state」例外に注意してください。WebSocket プロトコルを直接使用している場合は、「Missing required parameter」エラーが表示されます。

[tts:]Engine return error code: 418

原因：リアルタイム音声合成 (CosyVoice) を使用する際に、リクエストパラメーター voice (音色) が正しくないか、model と voice のバージョンが一致していません。

解決策：

voice パラメーターの割り当てを確認する：
- デフォルトの音色を使用している場合は、Python SDK の「voice パラメーター」セクションと照合して確認します。
- クローンされた音色を使用している場合は、CosyVoice 音声クローニング/デザイン API を使用して、音色のステータスが「OK」であり、音色が呼び出し元のアカウントと同じアカウントに属していることを確認します。
バージョンの互換性を確認する：v2 モデルは v2 音色のみ、v1 モデルは v1 音色のみ使用できます。バージョンを混在させないでください。

Request voice is invalid!

原因：リアルタイム音声合成 (CosyVoice) を使用している場合、このエラーは通常、音色が設定されていないために発生します。

解決策：voice パラメーターに値が割り当てられていることを確認します。WebSocket API リファレンスを使用している場合は、API ドキュメントで指定されている正しい JSON フォーマットでパラメーターを設定します。

ref_images_url and obj_or_bg must be the same length.

原因：Wanxiang - ビデオ編集 (2.1) の複数画像参照機能を使用する際に、ref_images_url と obj_or_bg の配列長が一致しません。

解決策：ref_images_url と obj_or_bg の配列長が同一であることを確認します。

check input data style.

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

解決策：入力パラメーターを確認し、修正します。

An error during model pre-process.

原因：content フィールドが不正なフォーマットで渡されました。

解決策：

コード経由で呼び出す場合、content を [{"type": "text", "text": "Who are you?"}] のような配列型に設定しないでください。

The image size is not supported for the data inspection.

原因：

Qwen VL モデルに渡された画像の寸法 (幅と高さ) がモデルの要件を満たしていません。
出力画像のサイズが 10 MB の制限を超えています。

解決策：

画像の寸法は以下を満たす必要があります：
- 幅と高さの両方が 10 ピクセル以上であること。
- アスペクト比が 200:1 または 1:200 を超えないこと。
生成される画像のパラメーターを調整します。

Wrong Content-Type of multimodal url

原因：URL レスポンスヘッダーの Content-Type フィールドが正しくありません。

Qwen VL モデルでサポートされているコンテンツタイプ：image/bmp、image/icns、image/x-icon、image/jpeg、image/jp2、image/png、image/sgi、image/tiff、image/webp。詳細については、「Qwen VL モデルでサポートされている画像フォーマット」をご参照ください。

解決策：

Content-Type フィールドの確認

ブラウザ (Chrome や Firefox など) を開きます。
デベロッパーツールを開きます (通常は F12 を押すか、右クリックして「検証」を選択します)。
ネットワークタブに切り替えます。
アドレスバーに画像 URL を入力してアクセスします。
対応するリクエストを見つけ、ヘッダー > レスポンスヘッダーの下にある Content-Type フィールドを探します。

Field required: image_url

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

解決策：「絵文字ビデオ生成」を参照し、image_url パラメーターを渡します。

Field required: driven_id

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

解決策：「絵文字ビデオ生成」を参照し、driven_id パラメーターを渡します。

Invalid ext_bbox

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

解決策：「絵文字ビデオ生成」を参照し、正しい ext_bbox を渡します。

Driven not exist: driven_id

原因：入力された driven_id が存在しません。

解決策：「絵文字ビデオ生成」を参照し、正しい driven_id を渡します。

Text request limit violated, expected 1.

原因：CosyVoice 音声合成 WebSocket API リファレンスを呼び出す際に、enable_ssml を true に設定し、continue-task 命令を複数回送信しました。

解決策：enable_ssml が true に設定されている場合、continue-task 命令は 1 回しか送信できません。

SSML text is not supported at the moment!

原因：CosyVoice 音声合成を使用する際に、現在のモデルまたは音色が SSML をサポートしていないか、SSML 機能が正しく有効になっていません。

解決策：「制限事項」に従ってトラブルシューティングを行います。

[tts:]Engine return error code: 428

原因：CosyVoice 音声合成の instruction パラメーターが正しく使用されていません。具体的な問題は次のとおりです：

長さ超過：instruction は 100 文字を超えることはできません (漢字は 2 文字、その他は 1 文字としてカウント)。
フォーマットまたは言語のエラー：以下のモデルのみが instruction をサポートしており、ルールが異なります：
- cosyvoice-v3.5-flash、cosyvoice-v3.5-plus：自由形式の命令が可能 (例：感情、速度)。
- cosyvoice-v3-flash：
  - 固定フォーマットに従う必要があります。
  - 中国語の instruction のみがサポートされています。
  - サポートされている instruction は音色によって異なります。詳細については、「CosyVoice 音色リスト」をご参照ください。

解決策：

instruction の文字数が 100 を超えていないことを確認します。
ご使用のモデルが instruction パラメーターをサポートしていることを確認します。
cosyvoice-v3-flash を使用する場合は、instruction が中国語であり、対応する音色の固定フォーマットに従っていることを確認します。

At least one of 'lyrics' or 'prompt' must be provided.

原因：Fun-Music モデルを使用する際に、リクエストに lyrics または prompt パラメーターが含まれていませんでした。

解決策：リクエストに lyrics または prompt の少なくとも 1 つを含めます。

Lyrics content is illegal and cannot be used for music generation.

原因：Fun-Music モデルを使用する際に、歌詞の内容がコンプライアンスチェックに失敗しました。侵害的な素材が含まれている可能性があります。

解決策：歌詞を修正して、侵害的または非準拠のコンテンツが含まれていないことを確認してから、再試行します。

400-invalid_request_error-invalid_value

-1 is lesser than the minimum of 0 - 'seed'/'seed' must be Integer

原因：OpenAI 互換プロトコルを使用する場合、seed パラメーターが [0, 2³¹-1] の範囲内にありません。

解決策：seed パラメーターを [0, 2³¹-1] の範囲内に設定します。

400-invalid_request_error

you must provide a model parameter.

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

解決策：リクエストに model パラメーターを追加します。

400-InvalidParameter.NotSupportEnableThinking

The model xxx does not support enable_thinking.

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

解決策：リクエストから enable_thinking パラメーターを削除するか、思考モードをサポートするモデルを使用します。

400-invalid_value

The requested voice 'xxx' is not supported.

原因：Qwen-TTS リアルタイム音声合成中に、選択された音色は Qwen-TTS 音声クローニングを使用して生成されましたが、使用されているモデルが異なります。

解決策：音声クローニング中に使用された target_model パラメーターが、音声合成中に使用された model パラメーターと一致することを確認します。

400-未払い

Access denied, please make sure your account is in good standing.

原因：API キーに関連付けられた Alibaba Cloud アカウントに支払い遅延があり、アクセスが拒否されました。

解決策：課金管理に移動して支払い遅延を確認します：

支払い遅延なし：API キーが現在のアカウントに属していることを確認します。
支払い遅延あり：速やかに再チャージします。再チャージ後、システムの残高更新が遅れる場合があります。しばらく待ってから再試行してください。

400-DataInspectionFailed/data_inspection_failed

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

原因：入力または出力に、コンテンツモデレーションによってブロックされた不適切なコンテンツが含まれている疑いがあります。

解決策：入力内容を修正して再試行します。

Input xxx data may contain inappropriate content.

原因：入力データ (プロンプトや画像など) に不適切なコンテンツが含まれている可能性があります。

解決策：コンテンツのコンプライアンスチェックを行い、入力を修正してから再試行します。

400-APIConnectionError

Connection error.

原因：ローカルネットワークの問題。通常はプロキシが有効になっているためです。

解決策：プロキシを無効にするか、再起動します。

400-InvalidFile.DownloadFailed

The audio file cannot be downloaded.

原因：音声認識 (Paraformer) を使用して録音ファイルを認識する際に、認識対象のファイルのダウンロードに失敗しました。

解決策：音声ファイルの URL がパブリックネットワーク経由でアクセス可能であることを確認します。

400-InvalidFile.AudioLengthError

Audio length must be between 1s and 300s.

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

解決策：音声の持続時間が [1, 300] 秒以内であることを確認します。

Audio length must be between 1s and 180s.

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

解決策：音声の持続時間が [1, 180] 秒以内であることを確認します。

400-InvalidFile.NoHuman

The input image has no human body. Please upload other image with single person.

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

解決策：1 人の人物が写っている写真をアップロードします。

400-InvalidFile.BodyProportion

The proportion of the detected person in the picture is too large or too small, please upload other image.

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

解決策：人物の比率要件を満たす画像をアップロードします。

400-InvalidFile.FacePose

The pose of the detected face is invalid, please upload other image with whole face and expected orientation.

原因：アップロードされた画像の顔のポーズが要件を満たしていません (顔が見える必要があり、頭の傾きは最小限に)。

解決策：要件を満たす画像をアップロードします。

The pose of the detected face is invalid, please upload other image with the expected oriention.

原因：アップロードされた画像の顔の向きが要件を満たしていません (顔に大きなずれがあってはなりません)。

解決策：画像内の顔に傾きがないことを確認します。

The pose of the detected face is invalid, please upload other image with the expected orientation.

原因：アップロードされた画像の顔のポーズが要件を満たしていません (顔に大きなずれがあってはなりません)。

解決策：画像内の顔に傾きがないことを確認します。

400-InvalidFile.Resolution

The image resolution is invalid, please make sure that the largest length of image is smaller than 7000, and the smallest length of image is larger than 400.

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

解決策：画像の解像度は 7000×7000 を超えず、400×400 以上である必要があります。

The image resolution is invalid, please make sure that the largest length of image is smaller than 4096, and the smallest length of image is larger than 224.

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

解決策：画像の解像度は、最長辺が 4096 ピクセル未満、最短辺が 224 ピクセル以上である必要があります。

The image resolution is invalid, please make sure that the largest length of image is smaller than xxx, and the smallest length of image is larger than yyy.

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

解決策：画像の解像度は xxx×xxx を超えず、yyy×yyy 以上である必要があります。

The image resolution is invalid, please make sure that the aspect ratio is smaller than xxx, and largest length of image is smaller than yyy.

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

解決策：画像のアスペクト比は xxx 未満であり、解像度は yyy×yyy を超えてはなりません。

Invalid video resolution. The height or width of video must be xxx ~ yyy.

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

解決策：ビデオの辺の長さは xxx と yyy の間でなければなりません。

400-InvalidFile.FPS

Invalid video FPS. The video FPS must be 15 ~ 60.

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

解決策：ビデオのフレームレートは 15～60 fps の間でなければなりません。

400-InvalidFile.Value

The value of the image is invalid, please upload other clearer image.

原因：アップロードされた画像が暗すぎます。

解決策：画像内の顔が鮮明であることを確認します。

400-InvalidFile.FrontBody

The pose of the detected person is invalid, please upload other image with the front view.

原因：アップロードされた画像は人物を後ろから写しています。

解決策：人物がカメラに直接向いていることを確認します。

400-InvalidFile.FullFace

The pose of the detected face is invalid, please upload other image with whole face.

原因：アップロードされた画像の顔のポーズが要件を満たしていません (顔が見える必要があります)。

解決策：画像内の顔が完全で遮られていないことを確認します。

400-InvalidFile.FaceNotMatch

There are no matched face in the video with the provided reference image.

原因：参照画像とビデオの顔照合に失敗しました。

解決策：詳細については、「VideoRetalk ビデオ生成」をご参照ください。

400-InvalidFile.Content

The first frame of input video has no human body. Please choose another clip.

原因：ビデオの最初のフレームに人物が含まれている必要があります。

解決策：人物が含まれるビデオクリップを選択します。

The human is too small in the first frame of input video. Please choose another clip.

原因：ビデオの最初のフレームの人物が小さすぎます。

解決策：最初のフレームで人物がより大きな割合を占めるビデオを選択します。

The human is not clear in the first frame of input video. Please choose another clip.

原因：ビデオの最初のフレームの人物が不鮮明です。

解決策：最初のフレームで人物が鮮明なビデオを選択します。

The input image has no human body or multi human bodies. Please upload other image with single person.

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

解決策：1 人の人物が写っている写真をアップロードします。

The input image has no human body or has unclear human body. Please upload other image.

原因：入力画像に不完全または欠落した人体が含まれています。

解決策：完全で鮮明な人体を含む画像をアップロードします。

The input image has multi human bodies. Please upload other image with single person.

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

解決策：1 人の人物が写っている写真をアップロードします。

400-InvalidFile.FullBody

The human is not fullbody in the first frame of input video. Please choose another clip.

原因：ビデオの最初のフレームの人物が全身ではありません。

解決策：全身が見える必要があります。

The pose of the detected person is invalid, please upload other image with whole body, or change the ratio parameter to 1:1。

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

解決策：要件を満たす画像をアップロードします：プロフィール写真の場合、頭が完全に見える必要があります。半身写真の場合、腰より上の部分が完全に見える必要があります。または、画像のアスペクト比を 1:1 に調整します。

400-InvalidFile.BodyPose

The pose of the detected person is invalid, please upload other image with whole body and expected orientation.

原因：1 人の人物のポーズが要件を満たしていません。

解決策：要件を満たす画像をアップロードします：肩と足首が見え、後ろ向きでなく、座っておらず、体の傾きが最小限である必要があります。

400-InvalidFile.Size

Invalid file size. The video file size must be less than 200MB, and the audio file size must be less than 15MB.

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

解決策：ビデオファイルは 200 MB 未満、音声ファイルは 15 MB 未満である必要があります。

Invalid file size, The image file size must be smaller than 5MB.

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

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

Invalid file size. The video/audio/image file size must be less than xxxMB.

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

解決策：ビデオ/音声/画像ファイルは指定された MB 制限未満である必要があります。

400-InvalidFile.Duration

Invalid file duration. The file duration must be xxx s ~ yyy s.

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

解決策：ビデオ/音声ファイルの持続時間は xxx 秒から yyy 秒の間でなければなりません。

400-InvalidFile.ImageSize

The size of image is beyond limit.

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

解決策：画像のアスペクト比は 2 を超えず、最長辺は 4096 を超えてはなりません。

400-InvalidFile.AspectRatio

Invalid file ratio. The file aspect ratio (height/width) must be between 3:1 and 1:3.

原因：ファイルのアスペクト比が要件を満たしていません。

解決策：ビデオファイルのアスペクト比は 3:1 から 1:3 の間でなければなりません。

Invalid file ratio. The file aspect ratio (height/width) must be between 2.0 and 0.5.

原因：ファイルのアスペクト比が要件を満たしていません。

解決策：画像ファイルのアスペクト比は 2.0 から 0.5 の間でなければなりません。

400-InvalidFile.Openerror

Invalid file, cannot open file as video/audio/image.

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

解決策：ファイルが破損していないか、フォーマットが正しいかを確認します。

400-InvalidFile.Template.Content

Invalid template content.

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

解決策：テンプレートの権限とコンテンツを確認します。

400-InvalidFile.Format

Invalid file format，the request file format is one of the following types: MP4, AVI, MOV, MP3, WAV, AAC, JPEG, JPG, PNG, BMP, and WEBP.

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

解決策：サポートされている形式を使用します：ビデオ — mp4、avi、mov。音声 — mp3、wav、aac。画像 — jpg、jpeg、png、bmp、webp。

400-InvalidFile.MultiHuman

The input image has multi human bodies. Please upload other image with single person.

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

解決策：1 人の人物が写っている写真をアップロードします。

400-InvalidPerson

The input image has no human body or multi human bodies. Please upload other image with single person.

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

解決策：1 人の人物が写っている写真をアップロードします。

400-InvalidParameter.DataInspection

Unable to download the media resource during the data inspection process.

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

解決策：中国以外から呼び出す場合、国境を越えるネットワークの不安定性によりダウンロードがタイムアウトする可能性があります。モデルを呼び出す前に、国内の OSS にファイルを保存します。または、一時記憶領域を使用してファイルをアップロードします。

400-FlowNotPublished

Flow has not published yet, please publish flow and try again.

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

解決策：フローを公開して再試行します。

400-InvalidImage.ImageSize

The size of image is beyond limit.

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

解決策：画像のアスペクト比は 2 を超えず、最長辺は 4096 を超えてはなりません。

400-InvalidImage.NoHumanFace

No human face detected.

原因：顔が検出されませんでした (生成タスクの非同期クエリインターフェイスのみ)。

解決策：鮮明な人の顔を含む画像をアップロードします。

400-InvalidImageResolution

The input image resolution is too large or small.

原因：入力画像の解像度が大きすぎるか小さすぎます。

解決策：画像の解像度は 256×256 ピクセル以上、5760×3240 ピクセル以下である必要があります。

400-InvalidImageFormat

The input image is in invalid format.

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

解決策：JPEG、PNG、JPG、BMP、または WEBP 形式の画像を使用します。

400-InvalidURL

Invalid URL provided in your request.

原因：URL が無効です。

解決策：有効な URL を使用します。

Required URL is missing or invalid, please check the request URL.

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

解決策：正しい URL を指定します。

The request URL is invalid, make sure the url is correct and is an image.

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

解決策：URL が正しく、画像ファイルを指していることを確認します。

The input audio is longer than xxs.

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

解決策：音声ファイルを xx 秒未満にトリミングします。

File size is larger than 15MB.

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

解決策：音声ファイルを 15 MB 未満に圧縮します。

File type is not supported. Allowed types are: .wav, .mp3.

原因：入力音声フォーマットが非準拠です。

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

The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP.

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

解決策：URL がアクセス可能で、画像形式が JPEG、JPG、PNG、BMP、または WEBP であることを確認します。

400-InvalidImage.FileFormat

Invalid image type. Please ensure the uploaded file is a valid image.

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

解決策：JPG、JPEG、PNG、BMP、または WEBP 形式の画像を使用します。

400-InvalidURL.ConnectionRefused

Connection to xxx refused, please provide available URL.

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

解決策：アクセス可能な URL を指定します。

400-InvalidURL.Timeout

Download xxx timeout, please check network connection.

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

解決策：ネットワーク接続を確認します。

400-BadRequestException

Invalid part type.

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

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

400-BadRequest.EmptyInput

Required input parameter missing from request.

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

解決策：リクエストに input パラメーターを追加します。

400-BadRequest.EmptyParameters

Required parameter "parameters" missing from request.

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

解決策：リクエストに parameters パラメーターを追加します。

400-BadRequest.EmptyModel

Required parameter "model" missing from request.

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

解決策：リクエストに model パラメーターを追加します。

400-BadRequest.IllegalInput

The input parameter requires json format.

原因：入力パラメーターのフォーマットが API の JSON 要件を満たしていません。

解決策：入力パラメーターのフォーマットを確認し、有効な JSON であることを確認します。

400-BadRequest.InputDownloadFailed

Failed to download the input file: xxx.

原因：入力ファイルのダウンロードに失敗しました。タイムアウト、ダウンロード失敗、またはファイルサイズが制限を超えている可能性があります。

解決策：詳細なエラーメッセージ xxx に基づいてトラブルシューティングを行います。

Failed to download the input file.

原因：Qwen-TTS 音声クローニングを使用する際に、サーバーがクローニング用の音声ファイルのダウンロードに失敗しました。

解決策：音声ファイルが正常にダウンロードできるか確認します。できる場合は、ファイルサイズが制限 (10 MB) を超えていないことを確認します。

400-BadRequest.UnsupportedFileFormat

File format unsupported.

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

解決策：音声フォーマットは WAV (16bit)、MP3、または M4A である必要があります。ファイル拡張子だけでは信頼できません。例えば、.mp3 拡張子のファイルが実際には Opus である可能性があります。ツール (ffprobe、mediainfo など) やコマンド (Linux/macOS の file コマンドなど) を使用して、実際の音声エンコード形式を確認します。

Input file format is not supported.

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

解決策：サポートされているファイル形式を使用します。

400-BadRequest.TooLarge

Payload Too Large.

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

解決策：

「purpose」が「file-extract」の場合、ドキュメントは 150 MB を超えてはならず、画像は 20 MB を超えてはなりません。
「purpose」が「batch」の場合、ファイルは 500 MB を超えてはなりません。バッチでファイルを分割してアップロードします。

400-BadRequest.ResourceNotExist

The Required resource not exist.

原因：

CosyVoice 音声クローニングの更新、クエリ、または削除インターフェイスを呼び出す際に、対応する音色が存在しません。

400-Throttling.AllocationQuota

Your current quota is xxx

原因：CosyVoice 音声クローニングの音色の数が制限に達しました。

解決策：いくつかの音色を削除します。

Maximum voice storage limit exceeded, please delete existing voices.

原因：Qwen-TTS 音声クローニングを使用する際に、メインアカウントの音色制限を超えました。

解決策：いくつかの音色を削除します。

400-ガーメント無効

Missing clothing image.Please input at least one top garment or bottom garment image.

原因：衣服の画像がありません。

解決策：少なくとも 1 つの上着 (top_garment_url) または下着 (bottom_garment_url) の画像を指定します。

400-InvalidSchema

Database schema is invalid for text2sql.

原因：データベーススキーマ情報が提供されていません。

解決策：データベーススキーマ情報を入力します。

400-InvalidSchemaFormat

Database schema format is invalid for text2sql.

原因：入力されたテーブル情報のフォーマットが無効です。

解決策：テーブル情報のフォーマットを確認し、修正します。

400-Audio.AudioShortError

valid audio too short!

原因：CosyVoice 音声クローニングの音声持続時間が短すぎます。

解決策：音声の持続時間を 10～15 秒程度に保ちます。5 秒以上の連続した音声セグメントが少なくとも 1 つ含まれるようにします。

400-Audio.AudioSilentError

silent audio error.

原因：CosyVoice 音声クローニングの音声ファイルが無音であるか、無音でないセグメントが短すぎます。

解決策：音声の持続時間を 10～15 秒程度に保ち、5 秒以上の連続した音声セグメントを少なくとも 1 つ含めます。

400-InvalidInputLength

The image resolution is invalid, please make sure that the largest length of image is smaller than 4096, and the smallest length of image is larger than 150. and the size of image ranges from 5KB to 5MB.

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

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

400-FaqRuleBlocked

Input or output data is blocked by faq rule.

原因：FAQ ルール介入モジュールがトリガーされました。

400-ClientDisconnect

Client disconnected before task finished!

原因：タスク完了前にクライアントが切断されました。このエラーは、音声合成または認識サービスを使用している場合に発生します。

解決策：タスク完了前にサーバーから切断しないようにコードを確認します。

400-ServiceUnavailableError

Role must be user or assistant and Content length must be greater than 0.

原因：入力コンテンツの長さが 0 であるか、role が正しくありません。

解決策：入力コンテンツの長さが 0 より大きいこと、およびパラメーターフォーマット (例：role) が API ドキュメントに準拠していることを確認します。

400-IPInfringementSuspect

Input data is suspected of being involved in IP infringement.

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

解決策：コンテンツのコンプライアンスチェックを行い、入力に侵害コンテンツが含まれていないことを確認します。

400-UnsupportedOperation

The operation is unsupported on the referee object.

原因：関連オブジェクトはこの操作をサポートしていません。

解決策：操作オブジェクトと操作タイプが一致していることを確認します。

The fine-tune job can not be deleted because it is succeeded,failed or canceled.

原因：ファインチューニングジョブのステータスがすでに「succeeded」、「failed」、または「canceled」であるため、削除できません。

解決策：特定の状態のジョブのみが削除できます。終了状態のジョブは削除しないでください。

400-CustomRoleBlocked

Input or output data may contain inappropriate content with custom rule.

原因：リクエストまたはレスポンスのコンテンツがカスタムポリシーチェックに失敗しました。

解決策：コンテンツを確認するか、カスタムポリシーを調整します。

400-Audio.PreprocessError

Audio preprocess error.

原因：Qwen-TTS 音声クローニングを使用する際に、クローンする音声の前処理に失敗しました。考えられる原因は、text パラメーターの内容が音声の書き起こしと大きく異なる、有効な音声が短すぎる、または音がないなどです。

解決策：text パラメーターの内容を調整します。効果がない場合は、録音ガイドラインに従って音声を再録音します。

No segments meet minimum duration requirement

原因：Qwen-TTS 音声クローニングを使用する際に、クローンする音声の有効な音声が短すぎます。

解決策：録音ガイドラインに従って音声を再録音します。

400-BadRequest.VoiceNotFound

Voice '%s' not found.

原因：Qwen-TTS 音声クローニングを使用する際に、削除インターフェイス呼び出しで指定された音色がすでに削除されているか、存在しません。

解決策：voice パラメーターが正しいことを確認します。

400-Audio.DecoderError

Decoder audio file failed.

原因：Qwen-TTS 音声クローニングを使用する際に、クローンする音声のデコードに失敗しました。/ CosyVoice 音声クローニングの音声ファイルデコードに失敗しました。

解決策：音声ファイルが破損していないか確認し、フォーマット要件 (CosyVoice の場合は WAV (16bit)、MP3、または M4A) を満たしていることを確認します。

400-Audio.AudioRateError

File sample rate unsupported.

原因：Qwen-TTS または CosyVoice 音声クローニングを使用する際に、クローンする音声のサンプルレートが要件を満たしていません。

解決策：サンプルレートは 24,000 Hz 以上である必要があります。

400-Audio.DurationLimitError

Audio duration exceeds maximum allowed limit.

原因：Qwen-TTS 音声クローニングを使用する際に、クローンする音声が長すぎます。

解決策：音声は 60 秒を超えてはなりません。

401-InvalidApiKey/invalid_api_key

Invalid API-key provided. / Incorrect API key provided.

原因：API キーが正しくありません。

解決策：一般的な原因と修正方法：

間違った環境変数の読み取り
- 間違い： api_key=os.getenv("sk-xxx") — システムは sk-xxx をキーとして使用するのではなく、sk-xxx という名前の環境変数を読み取ろうとします。
- 正しい：
  - 環境変数が設定されている場合： api_key=os.getenv("DASHSCOPE_API_KEY") を使用します。
    
    実行前に DASHSCOPE_API_KEY 環境変数が設定されていることを確認してください。
  - 環境変数が設定されていない場合： api_key = "sk-xxx" を使用します。
    
    この方法はデバッグ専用です。本番環境では使用しないでください。
タイプミス：Alibaba Cloud Model Studio の API キーは sk- で始まります。誤って他のプロバイダーのキーを使用していないか、コピー時に余分なスペースや改行が含まれていないかを確認します。
コーディングプラン専用 API キー：コーディングプランは専用の API キー ( sk-sp- で始まる) を提供しており、これは一般的な API キーとは異なり、専用の API エンドポイント (例：https://coding-intl.dashscope.aliyuncs.com/v1) と一緒に使用する必要があります。API キーとベース URL の両方を更新したことを確認してください。設定の詳細については、「AI ツールの統合」をご参照ください。

リージョンの不一致：API キーとベース URL が異なるリージョンに属している — 例えば、中国 (北京) の API キーをシンガポールのベース URL で使用している場合。API キーがシンガポールリージョンページ、北京リージョンページ、または米国リージョンページから取得したものであることを確認してください。リージョン別のベース URL：

リージョン	OpenAI 互換	DashScope
シンガポール	`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`	`https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1`
中国 (北京)	`https://dashscope.aliyuncs.com/compatible-mode/v1`	`https://dashscope.aliyuncs.com/api/v1`
米国 (バージニア)	`https://dashscope-us.aliyuncs.com/compatible-mode/v1`	`https://dashscope-us.aliyuncs.com/api/v1`

重要

Model Studio は、中国 (北京) およびシンガポールリージョン向けにワークスペース固有のドメインをリリースしました。新しい専用ドメインは、推論リクエストに対して優れたパフォーマンスと高い安定性を提供します。新しいドメインへの移行を推奨します：

中国 (北京)：https://dashscope.aliyuncs.com から https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com へ
シンガポール：https://dashscope-intl.aliyuncs.com から https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com へ

{WorkspaceId} は、Model Studio コンソールのワークスペース詳細ページで確認できるワークスペース ID です。既存のドメインは引き続き完全に機能します。

ツールの互換性の問題：サードパーティツールが正しく適合していない(例：最新のDifyプラグインの不安定性がエラーを引き起こす。古い Qwen プラグインのバージョンをインストールしてみてください。古いClineの場合、API プロバイダーとしてAlibaba Qwenの代わりにOpenAI互換を選択してください)。

いずれも当てはまらない場合は、API キーが削除されている可能性があります。再取得して再試行してください。

401 - 権限がありません

Access denied: Either you are not authorized to access this workspace, or the workspace does not exist. Please: Verify the workspace configuration. Check your API endpoint settings. Ensure you are targeting the correct environment.

原因：

WorkspaceId が無効であるか、現在のアカウントがワークスペースのメンバーではありません。
または、リクエストエンドポイント (サービスエンドポイント) が正しくありません。

解決策：

API を呼び出す前に、WorkspaceId が正しく、アカウントがワークスペースのメンバーであることを確認します。
中国サイトのユーザー：中国 (北京) リージョンのエンドポイントを使用します。国際サイトのユーザー：シンガポールリージョンのエンドポイントを使用します。オンラインデバッグを使用する場合、サービスエンドポイントが正しいことを確認します。

401-invalid access token or token expired

invalid access token or token expired.

考えられる原因：トークンプランが誤ってコーディングプランまたは他のプランのベース URL を使用しました。

解決策：トークンプラン専用のベース URL を使用します：

Anthropic 互換エンドポイント：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
OpenAI 互換エンドポイント：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

403-AccessDenied/access_denied

Current user api does not support asynchronous calls.

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

解決策：X-DashScope-Async ヘッダーを削除するか、その値を disable に設定します。

current user api does not support synchronous calls.

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

解決策：リクエストヘッダーに X-DashScope-Async: enable を設定します。

Invalid according to Policy: Policy expired.

原因：一時的なパブリック URL を取得する際に、ファイルアップロード認証情報が期限切れになりました。

解決策：ファイルアップロード認証情報 API を再呼び出しして、新しい認証情報を生成します。

アクセスが拒否されました。

原因：このモデルへのアクセス権がありません。モデルには承認が必要な場合や、無料クォータが枯渇し、従量課金をサポートしていない場合があります (例：deepseek-r1-distill-llama-70b)。

403-AccessDenied.Unpurchased

Access to model denied. Please make sure you are eligible for using the model.

原因：Alibaba Cloud Model Studio サービスが有効化されていません。

解決策：以下の手順に従って Alibaba Cloud Model Studio サービスを有効化します。

アカウントの作成：Alibaba Cloud アカウントをお持ちでない場合は、まず登録してください。
リージョンの選択：Alibaba Cloud Model Studio は、異なるエンドポイント、モデル、価格設定を持つ複数のリージョンをサポートしています。Model Studio コンソールに移動して、適切なリージョンを選択します。
本人確認の完了：Alibaba Cloud アカウントを使用して本人確認を完了します。
- 状況に応じて個人ユーザーを選択するか、エンタープライズにアップグレードし、今すぐ確認をクリックします。
- 詳細については、「本人確認の概要」をご参照ください。
Alibaba Cloud Model Studio の有効化：Alibaba Cloud アカウントを使用してAlibaba Cloud Model Studioに移動し、利用規約を読んで同意すると、サービスが自動的に有効化されます。サービス契約が表示されない場合は、すでに有効化されています。

403-Model.AccessDenied

Model access denied.

原因：指定された標準モデルを呼び出す権限がありません。

解決策：

標準モデルの呼び出し：サブワークスペースの API キーを使用して標準モデル (例：qwen-plus) を呼び出す場合、サブワークスペースには呼び出し権限が必要です。「モデル呼び出しの権限付与」をご参照ください。
カスタムモデルの呼び出し：デプロイが成功した後、カスタムモデルはワークスペースの API キーでのみ呼び出すことができ、モデル呼び出しの権限付与は不要です。

403-App.AccessDenied

アプリケーションのアクセス拒否。

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

解決策：

ワークスペースと RAM ユーザーにアクセス権限が付与されていることを確認します。
アプリケーションが公開されていることを確認します。
APP ID と API KEY を再確認します。
これが Claude Code のエラーである場合は、デフォルトのワークスペース API キーを使用します。
上記すべてが正しい場合は、データを更新し、再公開して再試行するか、エージェントを再作成します。

403-Workspace.AccessDenied

Workspace access denied.

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

解決策：

サブワークスペースモデルを呼び出す場合は、「サブワークスペースモデルの呼び出し」をご参照ください。
または、すべてのワークスペースに対する権限を持つメインアカウントの API KEY を使用します。

403-Endpoint.AccessDenied

Workspace endpoint access denied.

原因：非推奨のモデル (例：qwen-max-2025-01-25 のような過去のスナップショットバージョン) を呼び出している可能性があります。非推奨になると、エンドポイントは利用できなくなり、このエラーが発生します。

解決策：

モデルの非推奨メカニズムに移動して、モデルが非推奨であるかどうかを確認します。
非推奨の場合は、推奨される代替モデルに切り替えます。

403-AllocationQuota.FreeTierOnly

The free tier of the model has been exhausted. If you want to continue access the model on a paid basis, please disable the "use free tier only" mode in the management console.

原因 1：新規ユーザーが無料クォータを使い果たしてリクエストを行います。

解決策：呼び出す前にサインアップを完了します。

原因 2：無料クォータ枯渇時の停止を有効にし、無料クォータがなくなった後にリクエストを行いました。

コンソールの無料クォータは 1 分ごとに更新されます (手動でリフレッシュ)。

解決策：

有料で呼び出しを行うには、コンソールで無料クォータが枯渇したことが表示されるまで待ち、その後無料クォータ枯渇時の停止ボタンを無効にします。
コーディングプランを使用している場合、これは通常、設定エラーです。コーディングプランには専用のベース URL とAPI キーが必要です。詳細については、「コーディングプランクイックスタート」をご参照ください。

404-ModelNotFound/model_not_found

The provided model xxx is not supported by the Batch API.

原因：モデルがバッチ呼び出しをサポートしていないか、モデル名がスペルミスしています。

解決策：「OpenAI 互換 - バッチ (ファイル入力)」を参照して、サポートされているモデルと正しい名前を確認します。

Model can not be found. / The model xxx does not exist. / The model xxx does not exist or you do not have access to it.

原因：モデルが存在しないか、Alibaba Cloud Model Studio を有効化していません。

解決策：

モデルリストのモデル名と比較して、入力 (model パラメーターの値) を確認します。
モデルマーケットプレイスに移動して、モデルサービスを有効化します。

404-model_not_supported

Unsupported model xxx for OpenAI compatibility mode.

原因：モデルが OpenAI 互換アクセスをサポートしていません。

解決策：DashScope ネイティブメソッドを使用して呼び出します。

404-WorkSpaceNotFound

WorkSpace can not be found.

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

404-NotFound

Not found!

原因：

クエリ/操作するリソースが存在しません。

解決策：

クエリ/操作するリソース ID が間違っていないか確認します。

Request path not found.

原因：Fun-Music モデルを使用する際に、サービスエンドポイントが存在しません。

解決策：API パスが正しいか、異常な文字がないかを確認します。

429-Throttling

Requests throttling triggered.

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

解決策：呼び出し頻度を減らすか、後で再試行します。

Too many requests in route. Please try again later.

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

解決策：後で再試行します。

429-Throttling.RateQuota/LimitRequests/limit_requests

You have exceeded your request limit./Requests rate limit exceeded, please try again later. /You exceeded your current requests list.

原因：呼び出し頻度 (RPS/RPM) がレート制限をトリガーしました。

解決策：「レート制限」を参照して、呼び出し頻度を制御します。

429-Throttling.BurstRate/limit_burst_rate

Request rate increased too quickly. To ensure system stability, please adjust your client logic to scale requests more smoothly over time.

原因：レート制限に達する前に呼び出し頻度が急激に増加し、システム安定性保護がトリガーされました。

解決策：クライアントロジックを最適化して、スムーズなリクエスト戦略 (均一なスケジューリング、指数バックオフ、またはリクエストキューバッファリングなど) を使用して、リクエストを時間的に均等に分散させ、スパイクを回避します。

429-Throttling.AllocationQuota/insufficient_quota

Allocated quota exceeded, please increase your quota limit./ You exceeded your current quota, please check your plan and billing details.

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

解決策：モデルの制限については「レート制限」のドキュメントを参照し、呼び出し戦略を調整してください。デフォルトのクォータが不十分な場合は、Model Studio コンソールのレート制限の引き上げで一時的な TPM の引き上げをリクエストしてください。

レート制限のトリガーを回避するには、「よくある質問」をご参照ください。

Too many requests. Batch requests are being throttled due to system capacity limits. Please try again later.

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

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

無料割り当てクォータが上限を超えました。

原因：無料クォータが期限切れまたは枯渇し、モデルが従量課金をサポートしていません。

解決策：別のモデルに置き換えます。例えば、Qwen Audio モデルのクォータが枯渇した場合、非リアルタイム (Qwen-Omni) モデルを使用します。

Maximum voice-clone voice limit exceeded.

原因：Qwen-TTS 音声クローニングを使用する際に、メインアカウントの音色制限を超えました。

解決策：いくつかの音色を削除します。

429-CommodityNotPurchased

Commodity has not purchased yet.

原因：ワークスペースのサブスクリプションが購入されていません。

解決策：まずワークスペースサービスを購入します。

429-前払い料金の支払い延滞

The prepaid bill is overdue.

原因：ワークスペースの前払い請求書が期限切れです。

429-後払い請求の未払い

The postpaid bill is overdue.

原因：モデル推論サービスが期限切れです。

430-Audio.DecoderError

Decoder audio file failed.

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

解決策：ツール (ffprobe、mediainfo など) やコマンド (Linux/macOS の file コマンドなど) を使用して、実際の音声エンコード形式を確認します。

430-Audio.FileSizeExceed

File too large

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

解決策：音声クローニング用の音声ファイルは 10 MB 未満である必要があります。

430-Audio.AudioRateError

File sample rate unsupported

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

解決策：サンプルレートを 16 kHz 以上に設定します。

430-Audio.AudioSilentError

Silent file unsupported.

原因：CosyVoice 音声クローニングの音声ファイルが無音であるか、無音でないセグメントが短すぎます。

解決策：音声の持続時間を 10～15 秒程度に保ち、5 秒以上の連続した音声セグメントを少なくとも 1 つ含めます。

500-InternalError/internal_error

An internal error has occured, please try again later or contact service support.

原因：内部エラー。

解決策：

(Qwen-Omni) モデルを使用している場合は、ストリーミング出力を使用します。
CosyVoice 音声クローニングを使用している場合の考えられる原因：
- 音声ファイルが非標準である — 例えば、音質が悪い、ノイズが多い、音量が変動するなど。「録音ガイドライン」を参照して再試行してください。
- 録音ファイルの URL にアクセスできない。「CosyVoice 音声クローニング/デザイン API」の指示に従って再試行してください。
- 録音ファイルが長すぎる。10～15 秒程度の録音を使用し、少なくとも 1 つの連続した音声セグメントが 5 秒以上になるようにしてください。

内部サーバーエラー！

原因：内部アルゴリズムエラー。

解決策：後で再試行します。

audio preprocess server error

CosyVoice 音声クローニングを使用する場合：

原因：音声ファイルが非標準である — 例えば、音質が悪い、ノイズが多い、音量が変動するなど。

解決策：「録音ガイドライン」を参照して再試行してください。
原因：録音ファイルの URL にアクセスできない。

解決策：「CosyVoice 音声クローニング/デザイン API」の指示に従って再試行してください。
原因：録音ファイルが長すぎる。

解決策：10～15 秒程度の録音を使用し、少なくとも 1 つの連続した音声セグメントが 5 秒以上になるようにしてください。

request asr failed

原因：CosyVoice 音声クローニングを使用する際に、音声ファイルが非標準である — 有効な音声がない、または音声が不鮮明でノイズが多い。

解決策：「録音ガイドライン」を参照して再試行してください。

Remote cancelled grpc stream.

原因：音声合成で使用された音色が存在しません。

解決策：voice パラメーターを確認し、有効な音色名が指定されていることを確認します。利用可能な音色については、「リアルタイム音声合成 (CosyVoice)」をご参照ください。

500-InternalError.FileUpload

oss upload error.

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

解決策：OSS の構成とネットワークを確認します。

500-InternalError.Upload

Failed to upload result.

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

解決策：ストレージの構成を確認するか、後で再試行します。

500-InternalError.Algo

inference internal error.

原因：サービス例外。

解決策：まず再試行して、一時的な問題でないことを確認します。

Expecting ',' delimiter: line x column xxx (char xxx)

原因：モデルが生成した JSON データが無効で、ツール呼び出しができません。

解決策：最新のモデルに切り替えるか、プロンプトを最適化して再試行します。

Missing Content-Length of multimodal url.

原因：URL レスポンスヘッダーに Content-Length フィールドがありません。

解決策：解決しない場合は、別の画像リンクを試してください。

Content-Length フィールドの確認

ブラウザ (Chrome や Firefox など) を開きます。
デベロッパーツールを開きます (通常は F12 を押すか、右クリックして「検証」を選択します)。
ネットワークタブに切り替えます。
アドレスバーに画像 URL を入力してアクセスします。
対応するリクエストを見つけ、ヘッダー > レスポンスヘッダーの下にある Content-Length フィールドを探します。

An error occurred in model serving, error message is: [Request rejected by inference engine!]

原因：モデルサービスのバックエンドサーバーエラー。

解決策：後で再試行します。

An internal error has occured during algorithm execution.

原因：アルゴリズムの実行時エラー。

解決策：後で再試行します。

Inference error: Inference error.

原因：推論エラー。

解決策：画像ファイルが破損していないか、人物画像の品質が十分か (完全で鮮明な顔を含む必要がある) を確認します。

Role must be in [user, assistant]

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

解決策：messages 配列に 1 つの要素のみが含まれ、それがユーザーメッセージ (User Message) であることを確認します。

Embedding_pipeline_Error: xxx

原因：画像またはビデオの前処理エラー。

解決策：アップロードされた画像/ビデオとリクエストコードが要件を満たしていることを確認してから、再試行します。

Receive batching backend response failed!

原因：内部サービスエラー。

解決策：後で再試行します。

[music]Receive batching backend response failed!

原因：Fun-Music モデルを使用する際に、サービスの同時実行数制限を超えました。

解決策：同時リクエスト数を減らして再試行します。

Other kinds of server error.

原因：Fun-Music モデルを使用する際に、不明な内部システム例外が発生しました。

解決策：リクエスト ID を技術スタッフに提供してトラブルシューティングを依頼します。

An internal error has occured during execution, please try again later or contact service support. / algorithm process error. / inference error. / An internal error occurs during computation, please try this model later.

原因：内部アルゴリズムエラー。

解決策：後で再試行します。

list index out of range

原因：messages 配列の最後の要素は User Message である必要があります。

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

500-InternalError.Timeout

An internal timeout error has occured during execution, please try again later or contact service support.

原因：非同期タスクが 3 時間以内に結果を返さなかったため、タイムアウトが発生しました。

解決策：タスク実行を確認するか、サポートに連絡します。

500-SystemError

An system error has occured, please try again later.

原因：システムエラー。

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

500-ModelServiceFailed

Failed to request model service.

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

解決策：後で再試行します。

500-RequestTimeOut

Request timed out, please try again later. / Response timeout! / I/O error on POST request for "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions": timeout

原因：

大規模モデルを呼び出す際のリクエストタイムアウト。300 秒後にタイムアウトエラーが発生します。
音声認識 (Paraformer) を使用する際に、長時間サーバーに音声が送信されない、または長時間の無音状態。
画像生成または編集モデルを呼び出す際に、画像サイズが大きいか複雑性が高いため、処理時間が制限を超えています。

解決策：

ストリーミング出力を使用します。「ストリーミング出力」をご参照ください。
heartbeat パラメーターを true に設定するか、認識タスクを速やかに終了します。
画像モデルを呼び出す際は、解像度を下げる、編集を簡素化する、または後で再試行してみてください。

500-ResponseTimeout

Response stream timeout

原因：Fun-Music モデルを使用する際に、内部実行がタイムアウトしました。

解決策：呼び出しを再試行します。

500-InvokePluginFailed

Failed to invoke plugin.

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

解決策：プラグインの構成と可用性を確認します。

500-AppProcessFailed

Failed to proceed application request.

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

解決策：アプリケーションの構成とフローノードを確認します。

500-RewriteFailed

Failed to rewrite content for prompt.

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

解決策：後で再試行します。

500-RetrivalFailed

Failed to retrieve data from documents.

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

解決策：ドキュメントインデックスと取得構成を確認します。

500/503-ModelServingError

リクエストが多すぎます。システム容量の制限により、リクエストがスロットルされています。しばらく時間をおいてから再度お試しください。

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

解決策：後でもう一度お試しください。

503-ModelUnavailable

Model is unavailable, please try again later.

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

解決策：後で再試行します。

SDK エラー

error.AuthenticationError: No api key provided. You can set by dashscope.api_key = your_api_key in code, or you can set it via environment variable DASHSCOPE_API_KEY= your_api_key.

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

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

openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY environment variable

原因：OpenAI SDK を使用する際に API キーが渡されていません。

解決策：

環境変数を介して API キーを渡す (推奨)

DASHSCOPE_API_KEY を環境変数として設定し (「API キーを環境変数として設定する」を参照)、os.getenv で読み取って client を初期化します：

client = OpenAI(api_key=os.getenv("DASHSCOPE_API_KEY"),...)
API キーをハードコーディングする (テストのみ)

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

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

注意：これはセキュリティリスクをもたらすため、本番環境では使用しないでください。

Bad Request for url: xxx

原因：Python の requests ライブラリを使用する際に、response.raise_for_status() を追加すると、特定のサーバーエラーコンテンツを返さずにエラーが発生します。

解決策：print(response.json()) を使用してサーバーの応答を表示します。

Cannot resolve symbol 'ttsv2'

原因：リアルタイム音声合成 (CosyVoice) を使用している場合、この問題は古い DashScope SDK バージョンに起因します。

解決策：最新の DashScope SDK をインストールする。

NetworkError

NoApiKeyException: Can not find api-key.

原因：環境変数の構成が有効になりませんでした。

解決策：クライアントまたは IDE を再起動して再試行します。その他のシナリオについては、「よくある質問」をご参照ください。

ConnectException: Failed to connect to dashscope.aliyuncs.com

原因：ローカルネットワーク環境が異常です。

解決策：ローカルネットワークを確認します。例えば、証明書の問題で HTTPS アクセスがブロックされている、またはファイアウォールの設定が正しくないなどです。別のネットワークまたはサーバーを試してください。

InputRequiredException: Parameter invalid: text is null

原因：リアルタイム音声合成 (CosyVoice) を使用する際に、合成するテキストが送信されませんでした。

解決策：音声合成 API を呼び出す際に、text パラメーターに値を割り当てます。

MultiModalConversation.call() missing 1 required positional argument: 'messages'

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

解決策：最新の DashScope SDK をインストールする。

mismatched_model

The model 'xxx' for this request does not match the rest of the batch. Each batch must contain requests for a single model.

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

解決策：入力ファイルを「OpenAI 互換 - バッチ (ファイル入力)」と照合して確認します。

duplicate_custom_id

The custom_id 'xxx' for this request is a duplicate of another request. The custom_id parameter must be unique for each request in a batch.

原因：1 つのバッチタスク内では、各リクエスト ID は一意でなければなりません。

解決策：入力ファイルを「OpenAI 互換 - バッチ (ファイル入力)」と照合して、すべてのリクエスト ID が一意であることを確認します。

Upload file capacity exceed limit. / Upload file number exceed limit.

原因：アカウント下の Alibaba Cloud Model Studio ストレージスペースがいっぱい、またはほぼいっぱいのため、ファイルアップロードに失敗しました。

解決策：OpenAI 互換 - ファイルインターフェイスを介して不要なファイルを削除し、スペースを解放します。現在のストレージは最大 10,000 ファイル、合計 100 GB までサポートします。

WebSocket エラー

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

原因：ストリーミング音声認識 (Paraformer) を使用する際に、サービスが返した認識結果が大きすぎます。

解決策：音声をセグメントで送信します — 1 セグメントあたり約 100 ms、データサイズは 1 KB から 16 KB の間です。

TimeoutError: websocket connection could not established within 5s. Please check your network connection, firewall settings, or server status.

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

解決策：ローカルネットワーク、ファイアウォールの設定を確認するか、別のネットワークまたはサーバーを試してください。

unsupported audio format:xxx

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

解決策：音声フォーマットは WAV (16bit)、MP3、または M4A である必要があります。ファイル拡張子だけに頼らず、ツール (ffprobe、mediainfo など) やコマンドを使用して実際のエンコード形式を確認します。

internal unknown error

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

解決策：音声フォーマットは WAV (16bit)、MP3、または M4A である必要があります。ツールを使用して実際のエンコード形式を確認します。

Invalid backend response received (missing status name)

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

解決策：コードを API ドキュメントと照合して確認します。

NO_INPUT_AUDIO_ERROR

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

解決策：Paraformer リアルタイム音声認識を使用している場合は、次のようにトラブルシューティングします：

音声入力を確認します。
音声フォーマットを確認します (サポートされている形式：pcm、wav、mp3、opus、speex、aac、amr)。

SUCCESS_WITH_NO_VALID_FRAGMENT

原因：Paraformer 録音ファイル認識を使用している場合、認識結果のクエリは成功しましたが、VAD モジュールが有効な音声を検出しませんでした。

解決策：録音に有効な音声が含まれているか確認します。すべて無音の場合は、認識結果がないのが正常です。

ASR_RESPONSE_HAVE_NO_WORDS

原因：Paraformer 録音ファイル認識を使用している場合、認識結果のクエリは成功しましたが、最終結果は空です。

解決策：録音に有効な音声が含まれているか、または有効な音声がフィラーのみで構成されており、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:]Engine return error code: 411

原因：モデル qwen-tts-vc-realtime-2025-08-20 で Qwen-TTS リアルタイム音声合成を使用する際に、デフォルトの音色を使用しました。このモデルはクローンされた音色のみをサポートします。

解決策：デフォルトの音色ではなく、音声クローニングで生成された音色を使用します。

NO_VALID_AUDIO_ERROR

原因：音声認識 (Paraformer) を使用する際に、認識対象の音声が無効です。

解決策：音声フォーマット、サンプルレートなどが要件を満たしているか確認します。

InvalidParameter: task can not be null

原因：CosyVoice 音声合成 WebSocket API を使用する際に、run-task または finish-task のペイロードに input フィールドがないか、continue-task のペイロードに input.text がありません。

解決策：

run-task コマンドを確認する：ペイロードに "input": {} (空のオブジェクト) が含まれていることを確認します。input を省略しないでください。
continue-task コマンドを確認する：payload.input に空でない text フィールドが含まれていることを確認します。
finish-task コマンドを確認する：ペイロードに "input": {} が含まれていることを確認します。

200- BailianGateway.Workspace.NotAuthorised

原因：このエラーは、(1) アクセス URL に特殊文字や非標準フォーマットが含まれているためにワークスペースの権限検証に失敗した場合、または (2) RAM サブアカウントが権限のないワークスペースを操作した場合に発生する可能性があります。

解決策：(1) Model Studio コンソールのホームページに再度アクセスし、ターゲットページに移動します。(2) メインアカウントまたは管理者権限を持つ RAM アカウントが、サブアカウントに対応するワークスペースへのアクセス権を付与する必要があります。

コーディングプラン

Connection error

原因：ベース URL のタイプミスまたはネットワークの問題。

解決策：ベース URL のスペルとネットワーク接続を確認します。

hour allocated quota exceeded

原因：5 時間のリクエストクォータが枯渇しました。

解決策：クォータは 5 時間後に自動的にリセットされます。

week allocated quota exceeded

原因：週間のリクエストクォータが枯渇しました。

解決策：クォータは毎週月曜日の 00:00:00 (UTC+8) に自動的にリセットされます。

month allocated quota exceeded

原因：月間のリクエストクォータが枯渇しました。

解決策：クォータは毎月サブスクリプション日の 00:00:00 (UTC+8) に自動的にリセットされます。

concurrency allocated quota exceeded

原因：現在の同時リクエスト数が、プラットフォームが動的に割り当てた制限を超えています。

解決策：しばらくしてから再試行してください。プラットフォームは全体の負荷に基づいて同時実行数制限を動的に調整するため、ピーク時にはこの制限がトリガーされることがあります。

usage allocated quota exceeded. please try again later.

原因：呼び出し回数制限の他に、コーディングプランは短期的なリソース消費も評価します。短期的な消費量が多い場合、一時的なレート制限がトリガーされます。

解決策：通常は 1 時間以内に回復します。大きなタスクを小さなタスクに分割し、時間をかけて送信してください。