Alibaba Cloud Model Studio：錯誤資訊

400-InvalidParameter

parameter.enable_thinking must be set to false for non-streaming calls/parameter.enable_thinking only support stream call

原因： 使用非流式輸出方式調用了思考模式模型。

解決方案：請將enable_thinking參數設定為false，或者改用流式輸出方式調用思考模式模型。

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

原因： thinking_budget 參數不在可選值範圍內。

解決方案： 請參見模型列表中模型的最大思維鏈長度，指定為大於0且不超過該長度的值。

This model only support stream mode, please enable the stream parameter to access the model.

原因： 模型僅支援流式輸出，但調用時未啟用流式輸出。

解決方案： 請使用流式輸出方式調用模型。

This model does not support enable_search.

原因： 當前模型不支援連網搜尋能力，但指定了enable_search參數為true。

解決方案： 請調用支援連網搜尋能力的模型。

暫時不支援當前設定的語種！

原因： 使用 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將返回增量內容。

Range of input length should be [1, xxx]

原因： 調用模型時輸入內容長度超過模型上限。

解決方案：

• 若通過代碼調用，請控制 messages 數組中的 Token 數在模型最大輸入Token範圍內；

• 使用對話用戶端（如Chatbox）或阿里雲百鍊控制台進行連續對話時，每次請求都會附帶記錄，容易超出模型限制。超出限制後，請開啟新對話。

Range of max_tokens should be [1, xxx]

原因： max_tokens 參數設定未在 [1, 模型最大輸出 Token 數]的範圍內。

解決方案： 請參考模型最大輸出 Token 設定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.

原因： 當前介面不支援 GET 要求方法。

解決方案： 請查閱介面文檔，使用該介面支援的要求方法（如 POST 等）重新發起請求。

messages with role "tool" must be a response to a preceeding message with "tool_calls"

原因： 在工具調用時沒有向 messages 數組添加 Assistant Message。

解決方案： 請將模型第一輪響應的 Assistant Message 添加到 messages 數組後再添加 Tool Message。

Required body invalid, please check the request body format.

原因： 請求體（body）格式不符合介面要求。

解決方案： 請檢查請求體，確保為標準的JSON字串。常見問題有：多了,、括弧未閉合等。可藉助大模型協助修複請求體格式。

input content must be a string.

原因： 純文字模型不支援將 messages 中的 content 設定為非字串類型。

解決方案： 請勿將content設定為如[{"type": "text","text": "你是誰？"}]的數群組類型。

The content field is a required field.

原因： 發起請求時，未指定content參數，如{"role": "user"}。

解決方案： 請指定content參數。如{"role": "user","content": "你是誰"}。

current user api does not support http call.

原因：當前模型不支援非流式輸出。

解決方案：請使用流式輸出。

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

原因： 調用大模型時，既未指定messages參數，也未指定prompt參數（即將廢棄）。如果指定了messages參數後報錯，可能是因為格式錯誤，例如通過DashScope-HTTP時，messages需放入input對象中，而不是與model參數並列。

解決方案： 請指定messages參數。如果已指定但仍報錯，請參見通義千問API文檔，檢查其位置是否正確。

'messages' must contain the word 'json' in some form, to use 'response_format' of type 'json_object'.

原因： 使用結構化輸出時，提示詞中不包含 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"]

原因： 發起 Function Calling 時指定的 tool_choice 參數有誤。

解決方案： 請指定為 "auto"（由大模型自主選擇工具）或 "none"（強制不使用工具）。

Model not exist.

原因： 設定的model參數不存在。

解決方案： 可能是model參數大小寫有誤，或阿里雲百鍊沒有您需要調用的模型。請對照模型列表中的模型名稱，檢查輸入的model是否正確。

請勿混用開源社區的模型名與百鍊模型ID，如應該使用qwen3-235b-a22b-instruct-2507，而非Qwen/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文檔中模型的批次大小資訊，控制傳入文本的數量。

[] is too short

原因： 輸入的messages為空白數組。

解決方案： 請添加 message 後再發起請求。

The tool call is not supported.

原因： 使用的模型不支援傳入tools參數。

解決方案： 請更換為支援Function Calling的Qwen或DeepSeek模型。

Required parameter(xxx) missing or invalid, please check the request parameters.

原因： 介面調用參數不合法。

解決方案： 請檢查請求參數，確保所有必需參數都已提供且格式正確。

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:開頭, 在 Base 64 編碼資料前需要包含"base64"。

• 傳入本地路徑：需要以file://開頭。

• 傳入臨時URL：

  • 通過 HTTP 調用，需確保請求的 Header 中添加了參數 X-DashScope-OssResourceResolve: enable。

  • 通過 SDK 調用：僅支援 DashScope SDK調用，請勿使用 OpenAI SDK。

Input should be a valid dictionary or instance of GPT3Message

原因： messages 欄位的構造格式不符合要求，例如括弧數量不匹配、缺少必要的索引值對等。

解決方案： 請檢查messages欄位的JSON結構是否正確。

Value error, contents is neither str nor list of str.: input.contents

原因： 使用 Embedding 模型時，輸入不是字串也不是字串數組。

解決方案： 請修改輸入格式為字串或字串列表。

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 指向的媒體檔案，可能由以下原因導致。

• 連通性問題： 使用了阿里雲Object Storage Service服務內網地址。

• 網路延遲： 跨地區訪問引發逾時。

• 服務不穩定： 源儲存服務響應慢或不可達。

解決方案：

• 更換儲存服務

  建議使用與模型服務同地區的儲存服務。推薦使用阿里雲Object Storage Service服務產生公網連結（請勿使用內網地址）。

• 調整傳輸方式

  若傳入公網 URL 方式失敗，可參考傳入本地檔案（Base 64 編碼或檔案路徑）切換為推薦的傳入方式：

  檔案類型	檔案規格	DashScope SDK（Python、Java）	OpenAI 相容 / DashScope HTTP
  映像	大於 7MB 小於 10MB	傳入本地路徑	僅支援公網 URL，建議使用阿里雲Object Storage Service服務
  	小於 7MB	傳入本地路徑	Base 64 編碼
  視頻	大於 100 MB	僅支援公網 URL，建議使用阿里雲Object Storage Service服務	僅支援公網 URL，建議使用阿里雲Object Storage Service服務
  	大於 7MB 小於 100 MB	傳入本地路徑	僅支援公網 URL，建議使用阿里雲Object Storage Service服務
  	小於 7MB	傳入本地路徑	Base 64 編碼
  音頻	大於 10 MB	僅支援公網 URL，建議使用阿里雲Object Storage Service服務	僅支援公網 URL，建議使用阿里雲Object Storage Service服務
  	大於 7MB 小於 10 MB	傳入本地路徑	僅支援公網 URL，建議使用阿里雲Object Storage Service服務
  	小於 7MB	傳入本地路徑	Base 64 編碼

  Base 64 編碼會增巨量資料體積，原始檔案大小應小於 7 MB。

  使用 Base64 或本地路徑可避免服務端下載逾時，提升穩定性。

url error, please check url！

原因： 有以下兩種可能情況：

• DashScope SDK 版本過低：調用映像/視頻產生模型時，舊版SDK無法識別正確的服務端地址；

• 介面與模型不匹配：例如用多模態介面（如MultiModalConversation.call()）調用 qwen3-max 等純文字模型；或在直接發送 POST 請求時填寫了錯誤的 URL。

解決方案：

1. 升級SDK版本：若調用映像/視頻產生模型，請升級 SDK 版本。

2. 查閱 API 文檔：容易觸發此錯誤的模型與對應的介面如下：

   1. 多模態模型（如qwen3-vl-plus、qwen-vl-max）：MultiModalConversation.call()與POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation；

      若使用 spring-ai-alibaba 架構，請確認是否設定多模態參數withMultiModel。

      相關文檔：視覺理解。

   2. 純文字模型（如qwen3-max、qwen-plus、deepseek-v3.2）：Generation.call()與POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation。

      相關文檔：文本產生模型概述。

   3. CosyVoice聲音複刻介面：該介面包含 model 與 target_model 參數：需將 model 設定為 voice-enrollment， target_model 設定為具體的 CosyVoice 模型。

      相關文檔：CosyVoice聲音複刻API

請查閱對應模型的 API 文檔，使用匹配的介面。

check input data style.

原因： 輸入參數不滿足入參要求。

解決方案： 請檢查並修正輸入參數。

An error during model pre-process.

原因： 傳入了錯誤格式的 content 欄位。

解決方案：

• 若通過代碼調用，請勿將content設定為如[{"type": "text", "text": "你是誰？"}]的array類型。

The image size is not supported for the data inspection.

原因：

• 傳入通義千問VL模型的映像尺寸（長度和寬度）不符合模型的要求。

• 輸出映像大小超出限制（10MB）。

解決方案：

• 映像尺寸需滿足以下要求：

  • 映像的寬度和高度均不小於10像素。

  • 寬高比不應超過200:1或1:200

• 調整產生映像的參數。

Required parameter(data_sources) missing or invalid, please check the request parameters.

原因： 調用 SubmitIndexJob 介面時返回此錯誤，原因是調用 CreateIndex 介面時未指定必傳參數SourceType。

解決方案： 基於給定文檔建立知識庫時，此參數需傳入DATA_CENTER_FILE；基於給定類目建立知識庫時，此參數需傳入DATA_CENTER_CATEGORY。詳見CreateIndex文檔。

Wrong Content-Type of multimodal url

原因：URL請求的回應標頭資訊Content-Type欄位不正確。

通義千問VL模型支援的Content Type為：image/bmp、image/bmp、image/icns、image/x-icon、image/jpeg、image/jp2、image/png、image/sgi、image/tiff、image/webp。詳情可參見通義千問VL模型支援的映像。

解決方案：

Field required: image_url

原因： 缺少入參image_url。

解決方案： 請參考Emoji 視頻產生，傳入image_url參數。

Field required: driven_id

原因： 缺少入參driven_id。

解決方案： 請參考Emoji 視頻產生，傳入driven_id參數。

Invalid ext_bbox

原因： 輸入ext_bbox參數無效。

解決方案： 請參考Emoji 視頻產生，傳入正確的ext_bbox。

Driven not exist: driven_id

原因：輸入driven_id不存在。

解決方案： 請參考Emoji 視頻產生，傳入正確的driven_id。

Text request limit violated, expected 1.

原因：在調用CosyVoice語音合成的WebSocket API時，將enable_ssml設為true後多次發送continue-task指令。

解決方案： enable_ssml設為true後，只允許發送一次continue-task指令。

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-Arrearage

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

原因： API Key 所屬的阿里雲帳號存在欠費，導致訪問被拒絕。

解決方案：前往費用與成本查看是否欠費：

• 未欠費：請確認該 API Key 是否屬於當前帳號；

• 欠費：請及時儲值。儲值後，系統餘額可能存在延遲，請稍等後重試。

400-DataInspectionFailed/data_inspection_failed

Input or output data may contain inappropriate content. / Input data may contain inappropriate content. / Output data may contain inappropriate content.

原因： 輸入或者輸出包含疑似敏感內容被綠網攔截。

解決方案： 請修改輸入內容後重試。

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]秒範圍內。

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.

原因： 上傳圖片中人物面部姿態不符合要求（要求面部朝向無嚴重位移）。

解決方案： 請確保圖片中人臉朝向無偏斜。

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 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-60fps之間。

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.

原因： 檔案大小不符合要求。

解決方案： 視頻檔案必須小於200MB，音頻檔案必須小於15MB。

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

原因： 檔案大小不符合要求。

解決方案： 圖片檔案必須小於5MB。

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 s之間。

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-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 20s.

原因： 輸入的音頻檔案超過最大時間長度20秒。

解決方案： 請將音頻檔案裁剪至20秒以內。

File size is larger than 15MB.

原因： 輸入的音頻檔案超過最大限制15MB。

解決方案： 請將音頻檔案壓縮至15MB以內。

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聲音複刻時，伺服器下載待覆刻音頻失敗。

解決方案： 請檢查音頻檔案是否可以正常下載，若能下載，請檢查音頻檔案大小是否超出限制（超過10MB）。

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”時文檔不能超150MB、圖片不能超20MB。

• “purpose”參數為“batch”時，檔案不能超500MB。 請拆分並分批上傳檔案。

400-BadRequest.ResourceNotExist

The Required resource not exist.

原因：

• CosyVoice聲音複刻更新、查詢或刪除介面調用時，對應音色不存在。

• 使用定製熱詞（Paraformer）時，更新、查詢或刪除介面調用的熱詞資源不存在。

400-Throttling.AllocationQuota

您當前的配額為xxx

原因： CosyVoice聲音複刻音色數量已達限額。

解決方案： 刪除部分音色。

Free allocated quota exceeded.

原因： 使用定製熱詞（Paraformer）時，熱詞數目已超過上限（每個帳號預設10個）。

解決方案： 刪除部分熱詞。

Maximum voice storage limit exceeded, please delete existing voices.

原因： 使用Qwen-TTS聲音複刻時，超過主帳號可用的音色數目上限。

解決方案： 請刪除一部分音色或申請擴容。

400-InvalidGarment

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

原因： 缺少服飾圖片。

解決方案： 請至少提供一張上裝 (top_garment_url) 或下裝 (bottom_garment_url) 的圖片。

400-InvalidSchema

Database schema is invalid for text2sql.

原因： 未輸入資料庫Schema資訊。

解決方案： 請輸入資料庫Schema資訊。

400-InvalidSchemaFormat

Database schema format is invalid for text2sql.

原因： 輸入資料表資訊格式異常。

解決方案： 請檢查並修正資料表資訊的格式。

400-Audio.AudioShortError

valid audio too short!

原因： 用於CosyVoice聲音複刻的音頻有效時間長度過短。

解決方案：音頻時間長度應盡量控制在 10~15 秒之間。錄音時請確保朗讀連貫，並包含至少一段超過 5 秒的連續語音。

400-Audio.AudioSilentError

silent audio error.

原因： CosyVoice聲音複刻音頻檔案為靜音或非靜音長度過短。

解決方案： 用於聲音複刻的音頻時間長度應盡量控制在 10~15 秒之間，並包含至少一段超過 5 秒的連續語音。

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.

原因： 無法刪除該微調任務，因為其狀態已是“成功”、“失敗”或“已取消”。

解決方案： 只有處於特定狀態的任務才能被刪除，請勿刪除已終結狀態的任務。

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聲音複刻音頻檔案解碼失敗。

解決方案： 請檢查音頻檔案是否損壞，並確保音頻滿足音頻檔案格式要求（如Qwen-TTS）或為 WAV（16bit）、MP3 或 M4A（如CosyVoice）。

400-Audio.AudioRateError

File sample rate unsupported.

原因： 使用Qwen-TTS聲音複刻或CosyVoice聲音複刻時，待覆刻音頻採樣率不符合要求。

解決方案： 採樣率需大於等於24000 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 Key 填寫錯誤。

解決方案： 常見錯誤原因及修正方式如下：

• 讀取錯誤的環境變數

  • 錯誤寫法：api_key=os.getenv("sk-xxx") ，系統將嘗試讀取名為 sk-xxx 的環境變數，而非將 sk-xxx 當作密鑰。

  • 正確寫法：

    • 若已配置環境變數：請寫為api_key=os.getenv("DASHSCOPE_API_KEY")；

      確保運行前已設定DASHSCOPE_API_KEY環境變數。

    • 若未配置環境變數：請寫為api_key = "sk-xxx"。

      此方式便於調試，請勿用於生產環境。

• 工具適配問題：第三方工具未正確適配（如Dify最新版本外掛程式不穩定導致報錯，可嘗試安裝舊版本通義千問外掛程式；舊版本Cline調用模型時API Provider選擇了Alibaba Qwen，應選擇OpenAI Compatible）。

• 填寫錯誤：阿里雲百鍊的 API Key 以 sk- 開頭，請確認未誤填其他模型供應商的密鑰。

• 地區不匹配：API Key 和 Base URL 屬於不同的地區，例如使用了中國大陸（北京）地區的 API Key 和國際（新加坡）地區的 Base URL（含 -intl）。請確認您使用的 API Key 位於新加坡地區頁面還是北京地區頁面，各地區對應的 Base URL 如下：

  地區	OpenAI相容	DashScope
  國際（新加坡）	https://dashscope-intl.aliyuncs.com/compatible-mode/v1	https://dashscope-intl.aliyuncs.com/api/v1
  中國大陸（北京）	https://dashscope.aliyuncs.com/compatible-mode/v1	https://dashscope.aliyuncs.com/api/v1

若以上均不符合，可能是 API Key 被刪除，請重新擷取並發起調用。

401-NOT AUTHORIZED

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

原因：

• WorkspaceId值無效，或當前帳號不是該業務空間的成員。

• 或者請求的接入地址（服務存取點）有誤。

解決方案：

• 請確認WorkspaceId值無誤且帳號已是該業務空間的成員後，再調用介面。

• 中國站使用者請使用華北2（北京）地區的接入地址；國際站使用者請使用新加坡地區的接入地址。使用線上調試時，確認服務地址正確（如下圖）。

  

403-AccessDenied/access_denied

Current user api does not support asynchronous calls.

原因： 介面不支援非同步呼叫。

解決方案： 請移除要求標頭中的 X-DashScope-Async，或將其值設為 disable。

current user api does not support synchronous calls.

原因： 介面不支援同步調用。

解決方案： 請在要求標頭中設定 X-DashScope-Async: enable。

Invalid according to Policy: Policy expired.

原因： 在擷取臨時公網URL時，檔案上傳憑證已經到期。

解決方案： 請重新調用檔案上傳憑證介面產生新憑證。

Access denied.

原因： 無權訪問此模型。可能因該模型需申請許可權，或模型免費額度已耗盡且不支援付費使用（如 deepseek-r1-distill-llama-70b）。

403-AccessDenied.Unpurchased

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

原因： 未開通阿里雲百鍊服務。

解決方案： 請參照以下流程開通阿里雲百鍊服務。

1. 註冊帳號：如果沒有阿里雲帳號，您需要先註冊阿里雲帳號。

2. 選擇地區：阿里雲百鍊提供國際版（新加坡）和中國大陸版（北京）。兩個版本的控制台、存取點、提供的模型和價格等均有不同，請參見模型列表。

   • 國際版:  存取點和模型服務均位於中國大陸外，預設存取點為新加坡。

   • 中國大陸版:  存取點和模型服務均位於中國大陸，存取點當前僅支援北京。

3. 完成帳號認證：如果您需要開通中國大陸版（北京），本步驟是必需的。如果開通國際版（新加坡），可直接跳過。

   使用阿里雲主帳號完成帳號認證：

   • 按照您的情況，選擇個人認證或升級為企業，並點擊立即認證。

   • 在認證頁面的其他資訊地區，購買中國內地雲資源或者開啟包含中國內地加速地區，選擇有計劃。

   • 其餘資訊，請參見帳號認證概覽。

4. 開通阿里雲百鍊：使用阿里雲主帳號前往阿里雲百鍊大模型服務平台（新加坡或北京），閱讀並同意協議後，將自動開通阿里雲百鍊，如果未彈出服務合約，則表示您已經開通。

403-Model.AccessDenied

Model access denied.

原因： 無許可權調用對應的標準模型。

解決方案：

• 調用標準模型：使用子業務空間的API-KEY調用標準模型（例如qwen-plus）時，子業務空間需具備該模型的調用許可權。詳見模型調用授權。

• 調用自訂模型：自訂模型部署成功後，僅能用其所在業務空間的API-KEY調用，且無需模型調用授權。

403-App.AccessDenied

App access denied.

原因： 無許可權訪問應用或者模型。

解決方案：

• 仔細確認對訪問的業務空間和子帳號做了訪問授權。

• 仔細檢查應用是否發布。

• 仔細核實傳入的APP ID、API KEY是否正確。

• 如果是Claude Code報錯，請使用預設業務空間的API Key。

• 若上述建議都正確，建議重新整理資料重新發布再調用，或嘗試重新建立智能體。

403-Workspace.AccessDenied

Workspace access denied.

原因： 無許可權訪問業務空間的應用或者模型。

解決方案：

• 如果調用子業務空間的模型，請參考子業務空間的模型調用。

• 也可改為使用主帳號的API KEY，主帳號具有所有業務空間的許可權。

403-AllocationQuota.FreeTierOnly

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

原因：開啟了免費額度用完即停，且免費額度耗盡後發起請求。

控制台免費額度顯示有小時級延遲。即使額度已用完，介面仍可能顯示剩餘額度。

解決方案：如需付費調用，請等待控制台顯示免費額度用完後，關閉免費額度用完即停按鈕。

404-ModelNotFound/model_not_found

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

原因： 當前模型暫不支援 Batch 調用，或者可能存在模型名稱拼字錯誤。

解決方案： 請參考OpenAI相容-Batch，確認支援 Batch調用的模型及其正確名稱。

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.

原因： 當前訪問的模型不存在，或您還未開通阿里雲百鍊服務。

解決方案：

• 請對照模型列表中的模型名稱，檢查您輸入的模型名稱（參數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無效或對應熱詞不存在。

解決方案：

• 請檢查要查詢/操作的資源ID是否錯誤。

• 檢查熱詞ID是否正確並參照API文檔按照正確的方式進行調用。

429-Throttling

Requests throttling triggered.

原因： 介面調用觸發限流。

解決方案： 請降低調用頻率或稍後重試。

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.

原因： 每秒鐘或每分鐘消耗Token數（TPS/TPM）觸發限流。

解決方案： 前往限流文檔查看模型限流條件並調整調用策略。

可參考限流FAQ避免觸發限流。

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

原因： Batch請求過多觸發限流。

解決方案： 暫時無法處理您的請求，請稍後再進行重試。

Free allocated quota exceeded.

原因： 免費額度已到期或耗盡，且該模型暫不支援隨用隨付。

解決方案： 使用其它模型替換，例如：通義千問Audio模型額度耗盡，可使用全模態模型。

429-CommodityNotPurchased

Commodity has not purchased yet.

原因： 業務空間未訂購。

解決方案： 請先訂購業務空間服務。

429-PrepaidBillOverdue

The prepaid bill is overdue.

原因： 業務空間預付費賬單到期。

429-PostpaidBillOverdue

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聲音複刻音頻檔案大小超限。

解決方案： 用於聲音複刻的音頻檔案需10M以內。

430-Audio.AudioRateError

File sample rate unsupported

原因： CosyVoice聲音複刻音頻檔案採樣率不支援。

解決方案： 採樣率設定為16KHz及以上。

430-Audio.AudioSilentError

Silent file unsupported.

原因：CosyVoice聲音複刻音頻檔案為靜音或非靜音長度過短。

解決方案： 音頻時間長度應盡量控制在 10~15 秒之間，並包含至少一段超過 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秒的錄音。錄音時請確保朗讀連貫，並包含至少一段超過 5 秒的連續語音。

Internal server error!

原因： 內部演算法錯誤。

解決方案： 請稍後重試。

audio preprocess server error

使用CosyVoice聲音複刻：

• 原因：音頻檔案不規範，比如聲音本身有問題，有雜音或者聲音忽高忽低。

  解決方案：請參見錄音操作指南錄音後重試。

• 原因：錄音檔案URL無法訪問，

  解決方案：請按照CosyVoice聲音複刻API中的說明操作後重試。

• 原因：錄音檔案時間長度過長。

  解決方案：盡量選擇10~15秒的錄音。錄音時請確保朗讀連貫，並包含至少一段超過 5 秒的連續語音。

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欄位。

解決方案： 如果問題無法解決，請嘗試使用其他圖片連結。

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數組中僅包含一個元素，且該元素必須是使用者訊息（User Message）。

Embedding_pipeline_Error: xxx

原因： 映像或視頻預先處理出錯。

解決方案： 請確認上傳的圖片或視頻及請求代碼符合要求後重試。

Receive batching backend response failed!

原因： 服務內部錯誤。

解決方案： 請稍後重試。

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-InvokePluginFailed

Failed to invoke plugin.

原因： 外掛程式調用失敗。

解決方案： 請檢查外掛程式配置和可用性。

500-AppProcessFailed

Failed to proceed application request.

原因： 應用流程處理失敗。

解決方案： 請檢查應用配置和流程節點。

500-RewriteFailed

Failed to rewrite content for prompt.

原因： 調用改寫prompt的大模型失敗。

解決方案： 請稍後重試。

500-RetrivalFailed

Failed to retrieve data from documents.

原因： 文檔檢索失敗。

解決方案： 請檢查文檔索引和檢索配置。

503-ModelServingError

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

原因： 網路資源目前處於飽和狀態，暫時無法處理您的請求。

解決方案： 請稍後再進行嘗試。

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 Key。

解決方案： 具體配置API Key的方法，請參見配置API Key到環境變數（準備下線，併入配置 API Key）。

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 Key。

解決方案：

• 通過環境變數傳入 API Key 來源（推薦）

  將DASHSCOPE_API_KEY設為環境變數（參見配置API Key到環境變數（準備下線，併入配置 API Key）），初始化client時，通過os.getenv讀取：

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

• 明文傳入 API Key（僅限測試）

  直接將 API Key 傳入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）時未發送待合成文本。

解決方案：調用語音合成介面時為 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.

原因： 在單個 Batch 任務中，所有請求都必須選用同一個模型。

解決方案： 請根據輸入檔案檢查您的輸入檔案。

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.

原因： 在單個 Batch 任務中，每條請求的 ID 必須唯一。

解決方案： 請根據輸入檔案檢查您的輸入檔案，確保所有請求 ID 不重複。

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

原因： 上傳檔案失敗，當前阿里雲帳號下的阿里雲百鍊儲存空間已滿或接近滿額。

解決方案： 可以通過OpenAI相容-File介面刪除不需要的檔案以釋放空間。當前儲存空間支援最大檔案數為10000個，總量不超過100 GB。

WebSocket 報錯

The decoded text message was too big for the output buffer and the endpoint does not support partial messages

原因： 使用語音辨識（Paraformer）的流式語音辨識時，服務返回的識別結果資料量過大。

解決方案： 請分段發送待識別音頻，建議每次發送的音頻時間長度約為100毫秒，資料大小保持在1KB至16KB之間。

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

原因： 若您使用語音合成（CosyVoice），無法在5秒內建立websocket串連。

解決方案： 請檢查本網、防火牆設定，或更換網路環境或伺服器進行測試。

unsupported audio format:xxx

原因： CosyVoice聲音複刻時，上傳的音頻格式不符合模型要求。

解決方案： 音頻格式需為 WAV（16bit）、MP3 或 M4A。請注意，不能僅憑檔案尾碼名判斷格式，建議通過工具（如ffprobe、mediainfo）或命令（如Linux/macOS的file命令）確認音頻檔案的實際編碼格式。

internal unknown error

原因： CosyVoice聲音複刻音頻檔案格式可能不符合要求。

解決方案： 音頻格式需為 WAV（16bit）、MP3 或 M4A。建議通過工具（如ffprobe、mediainfo）或命令確認音頻檔案的實際編碼格式。

Invalid backend response received (missing status name)

原因： 使用語音辨識（Paraformer）的錄音檔案識別的RESTful API時，請求參數拼字有誤。

解決方案： 請參照API文檔檢查代碼。

NO_INPUT_AUDIO_ERROR

原因： 未檢測到有效語音。

解決方案： 若您使用語音辨識（Paraformer）即時語音辨識，請通過如下方式排查：

1. 檢查是否有音頻輸入。

2. 檢查音頻格式是否正確（支援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）錄音檔案識別，待識別檔案過大。

解決方案： 請檢查錄音檔案大小是否超過2GB，超過則需您對錄音檔案分段。

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 response中的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）時，待識別音頻無效。 解決方案： 請檢查音頻格式、採樣率等是否滿足要求。