エラーコード - 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" を持つ先行するメッセージへの応答でなければなりません。

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

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

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

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

解決策: リクエストボディが有効な JSON であることを確認してください。よくある問題として、末尾のカンマ (,) や閉じていない括弧などがあります。large モデルを使用して、リクエストボディのフォーマットを修正できます。

input content must be a string.

原因：プレーンテキストモデルは、messages の 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 リファレンスを参照して、その配置を確認してください。

'response_format' の type が 'json_object' の場合、'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 以外の値に設定します。

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"]

原因： Function Calling 中に tool_choice パラメーターが不正です。

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

モデルが存在しません。

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

解決策：

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

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 モデルに切り替えます。

The provided messages input is invalid. The error info is [Unexpected item type in content] / Input should be a valid string / Input should be a valid dictionary or instance of ... (input.messages.x.content...)

原因: messages 配列内のメッセージの content フィールドに、サポートされていない型のアイテムが含まれています。content が配列の場合、各要素は文字列または有効なオブジェクト (たとえば {"type": "text", "text": "..."} や {"type": "image_url", ...}) である必要があります。数値、ブール値、ネストされた配列、または type がサポートされていないオブジェクトを渡すと、このエラーがトリガーされます。対応する HTTP ステータスコードは 400 で、エラーコードは InternalError.Algo.InvalidParameter です。

一般的なシナリオ: テキスト専用モデル (Qwen-Max テキストシリーズの qwen3-max など) を使用し、messages (特にマルチターン対話履歴) にイメージ (image_url) などのマルチモーダルな content アイテムが含まれている場合、このエラーもトリガーされます。これは、テキスト専用モデルがイメージやその他のモダリティの入力を受け付けないためです。一部の統合ツールやエージェントでは、このエラーは「the model provider returned empty content」のようなメッセージとして表示されることがあります。

解決策：

テキスト専用モデル: content には、配列やその他の型ではなく文字列を設定します。テストケースでイメージやその他のマルチモーダル入力が必要な場合は、マルチモーダルモデル (Qwen-VL または Qwen3-VL シリーズなど) に切り替えます。テキスト専用モデルを引き続き使用する必要がある場合は、呼び出す前に、messages と会話履歴からイメージ (image_url) などのマルチモーダルアイテムを削除します。
マルチモーダルモデル: content 配列の各要素は、有効なオブジェクトである必要があります。その type は、モデルでサポートされているモダリティタイプ (text、image_url、video_url、video など) のいずれかでなければなりません。数値、ブール値、ネストされた配列、type がない要素、または type の値が無効な要素は含めないでください。

必須パラメーター (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 エンコーディング後、単一ファイルは 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 ユーザーの違い：「必須パラメーターの欠落」はサーバーから返されるプロトコルレベルのエラーであり、WebSocket プロトコルを直接使用する場合にのみ表示されます。DashScope Java SDK の Recognition クラスを使用する場合、SDK はクライアント側でこの操作をインターセプトし、「無効な状態」例外 (「期待される認識状態は開始済みであるべきですが、現在の状態はアイドルです」) をスローし、「必須パラメーターの欠落」エラーは返しません。

解決策：

原因 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 フィールドが正しくないフォーマットで渡されました。

解決策：

コードから呼び出す場合、コンテンツを [{"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 に設定されている場合、タスクの続行命令を 1 回のみ送信できます。

SSML text is not supported at the moment!

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

解決策：「使用制限」に従ってトラブルシューティングを行ってください。

[tts:]Engine return error code: 428

原因: CosyVoice の音声合成 instruction パラメーターが正しく使用されていません。具体的な問題として、以下が考えられます。

文字数超過: 命令は 100 文字を超えることはできません (漢字は 2 文字、その他は 1 文字としてカウントされます)。
書式または言語のエラー: 以下のモデルのみが、それぞれ異なるルールで 命令 をサポートします。
- cosyvoice-v3.5-flash, cosyvoice-v3.5-plus: 自由形式の命令が許可されています (例：感情、速度)。
- cosyvoice-v3-flash:
  - 固定フォーマットに従う必要があります。
  - 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 のいずれかを含めてください。

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-滞納

アクセスが拒否されました。アカウントが正常な状態であることを確認してください。

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

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

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

API provider returned a billing error — your API key has run out of credits or has an insufficient balance. Check your provider's billing dashboard and top up or switch to a different API key.

原因：OpenClaw などのサードパーティクライアントを介して Model Studio を呼び出す際、基盤となるアカウントに支払い遅延または残高不足がある場合、クライアントはサーバー側の課金エラーをこのメッセージに集約します。基盤となる Model Studio サーバー側のエラーコードは Arrearage です (つまり、上記のAccess denied, please make sure your account is in good standing. メッセージ)。これはクライアント自体の課金の問題ではありません。

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

400-DataInspectionFailed/data_inspection_failed

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

原因：入力または出力に、グリーンネットによってブロックされた疑わしい機密コンテンツが含まれています。

解決策：入力内容を修正して再試行してください。

Input xxx data may contain inappropriate content.

原因：入力データ (プロンプトや画像など) に機密コンテンツが含まれている可能性があります。解決策：コンテンツのコンプライアンスチェックを行い、入力を修正してから再試行してください。

Qwen rejected the input image before model inference; no actual ad/porn/OCR result was produced.

原因：入力画像がモデル推論に入る前に、コンテンツ安全性の事前チェック (グリーンネット) によって、機密または非準拠のコンテンツが含まれている疑いがあるとフラグ付けされ、ブロックされました。モデルは画像に対して推論を実行しなかったため、認識、OCR、または分析結果は返されません。これは、マルチモーダル入力画像に対する推論前のコンテンツコンプライアンスチェックであり、上記のグリーンネットブロッキングと同じコンテンツ安全メカニズムに属します。

解決策：入力画像を置き換えるか修正して再試行してください。画像が準拠していることが確認されているにもかかわらず、一貫してブロックされる場合は、さらなる検証のためにチケットを送信してください。

400-API 接続エラー

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.

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

解決策：一人写りの写真をアップロードします。

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.

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

解決策：一人写りの写真をアップロードします。

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.

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

解決策：一人写りの写真をアップロードします。

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.

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

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

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.

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

解決策：一人写りの写真をアップロードします。

400-InvalidPerson

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

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

解決策：一人写りの写真をアップロードします。

400-InvalidParameter.DataInspection

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

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

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

400 - フロー未公開

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 (16 ビット)、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 秒程度に保ちます。少なくとも 1 つの 5 秒以上の連続した音声セグメントがあることを確認します。

400-Audio.AudioSilentError

silent audio error.

原因：CosyVoice 音声クローニングオーディオファイルがサイレントであるか、非サイレントセグメントが短すぎます。

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

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 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、または ロール が不正です。

解決策: 入力コンテンツの長さが 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.

原因：ファインチューニングジョブのステータスがすでに「成功」、「失敗」、または「キャンセル」であるため、削除できません。

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

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 キー (Coding Plan / Token Plan Team Edition): Coding Plan と Token Plan Team Edition は両方とも、sk-sp- で始まる専用 API キーを提供します。このキーは独自の専用 Base URL と一緒に使用する必要があり、一般的な API キー/Base URL と混在させてはなりません (混在させると、この認証エラーが返されます)。Coding Plan の場合、専用エンドポイントは https://coding-intl.dashscope.aliyuncs.com/v1 です。Token Plan Team Edition の場合、専用 Base URL はコンソールの [マイサブスクリプション] の API キーエリアに表示されます。API キーと Base URL の両方を更新したことを確認してください。構成の詳細については、AI ツールの統合およびToken Plan Team Edition クイックスタートをご参照ください。

リージョンの不一致：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`

重要

Alibaba Cloud 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} はお客様のワークスペース ID で、Alibaba Cloud Model Studio コンソールの[ワークスペース詳細] ページで確認できます。既存のドメインは引き続き完全に機能します。

ツールの互換性の問題：サードパーティツールが正しく適合していません(例：最新の 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 を再呼び出しして、新しい認証情報を生成します。

Access denied.

原因: このモデルにアクセスする権限がありません。モデルが承認を必要とするか、その無料クォータが使い果たされ、従量課金に対応していない可能性があります (例: 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：無料クォータ枯渇時の停止を有効にし、無料クォータがなくなった後にリクエストを行いました。

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

解決策：

有料で呼び出しを続けるには、無料クォータが使い果たされるのを待たずに、いつでも無料クォータ枯渇時の停止スイッチを無効にできます。無効にすると、従量課金での呼び出しが再開されます。
コーディングプランを使用している場合、これは通常、構成エラーです。コーディングプランには専用のベース 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.

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

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

All models are temporarily rate-limited. Please try again in a few minutes.

原因：コーディングプランなどのサービスを使用してクライアント (例：Claude Code) を介して複数のモデルを呼び出す際、利用可能なすべてのモデルが 429 レート制限をトリガーした場合に、クライアントからこのメッセージが返されます。基盤となる Model Studio サーバー側のエラーコードは Throttling.RateQuota または Throttling.AllocationQuota です。

解決策：

数分待ってから再試行してください。レート制限は自動的に解除されます。
短期間に多くのリクエストを送信しないように、リクエストの同時実行数を減らします。
レート制限を増やすには、「レート制限」を参照してクォータの増加をリクエストしてください。

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-PrepaidBillOverdue：前払い料金の延滞

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 秒程度に保ち、少なくとも 1 つの 5 秒以上の連続した音声セグメントを含めます。

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 である必要があります。

解決策: 最後の要素が {"role": "user", ...} になるように、messages 配列の順序を調整します。

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.

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

解決策：入力ファイルを「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.

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

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

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

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

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

WebSocket エラー

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

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

解決策：オーディオをセグメントで送信します。セグメントあたり約 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 リアルタイム音声合成でモデル qwen-tts-vc-realtime-2025-08-20 を使用する際に、デフォルトの音色が使用されました。このモデルは、クローンされた音色のみをサポートします。

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

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 アカウントが、対応するワークスペースへのアクセス権をサブアカウントに付与する必要があります。

200- BailianGateway.Team.NotAuthorised

原因：現在の RAM サブアカウントには、アクセスしているチーム (組織) の権限がありません。RAM サブアカウントが権限のないチーム (組織) のリソースにアクセスすると、ゲートウェイのチームレベルの権限チェックが失敗し、このエラーが返されます。

解決策：メインアカウントまたは管理者権限を持つ RAM アカウントが、RAM サブアカウントを対応するチーム (組織) に追加し、権限管理で適切な権限を付与する必要があります。

コーディングプラン

Connection error

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

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

hour allocated quota exceeded

原因：5 時間のリクエストクォータを使い果たしました。

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

week allocated quota exceeded

原因：週間のリクエストクォータを使い果たしました。

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

month allocated quota exceeded

原因：月間のリクエストクォータを使い果たしました。

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

concurrency allocated quota exceeded

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

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

usage allocated quota exceeded. please try again later.

原因：呼び出し回数の制限を超えて、コーディングプランは短期的なリソース消費も評価します。短期的な消費が高いと、一時的なレート制限がトリガーされます。

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