错误信息

HTTP 返回码

错误代码 Code

错误信息 Message

说明

-

-

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 配置到环境变量 。

-

-

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

未传入 API Key。您可以参考 常见问题 将 API Key 正确配置到环境变量，或将 API  Key 作为明文写入代码中（不建议）。

-

-

Bad Request for url: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

使用 Python requests 库时，添加 response.raise_for_status() 语句导致报错时不返回服务端的具体错误内容。

请用 print(response.json()) 查看服务端返回信息。

-

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 不重复。

-

model_not_found

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

当前模型暂不支持 Batch 调用，或者可能存在模型名称拼写错误。请参考 支持的模型列表 ，确认支持 Batch 调用的模型及其正确名称。

-

InvalidParameter

invalid_request_error

Required body invalid, please check the request body format.

请求体（body）格式不符合 API 的要求。可能原因有：

• 请求体存在语法错误（如 JSON 数据可能存在缺少引号、括号不闭合等问题、CMD 中需用 \" 表示双引号）。

• 请求体中的特殊字符没有被正确编码（例如，CMD 终端默认编码非 UTF-8，可能导致请求体中的中文字符被错误编码）。

request timeout after 23 seconds

超过 23 秒未向服务发送数据。该报错信息在您使用 语音合成-Sambert 、 语音识别/翻译-Gummy 、 语音识别-Paraformer 和 语音合成-CosyVoice 时产生。请检查为什么长时间未向服务器发送数据。如果长时间（超过 23 秒）不向服务端发送消息，请及时结束任务。

Please ensure input text is valid

若您使用 语音合成-CosyVoice ，此错误通常是由于未发送待合成文本引起的。

请根据以下可能原因进行排查：

1. 参数遗漏：在语音合成时，可能忘记为 text 参数赋值。

2. 代码异常：某些代码逻辑可能导致对 text 参数的赋值失败。

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

若您使用 语音合成-CosyVoice ，此错误通常是由于发送 run-task 指令 未指定 model 参数。

[tts:]Engine return error code: 418

若您使用 语音合成-CosyVoice ，请按以下步骤检查请求参数 voice （音色）是否正确：

1. 检查 voice 参数赋值：

   • 如果使用的是默认音色，请对照 音色列表 中的“voice 参数”进行确认。

   • 如果使用的是声音复刻音色：

     • 检查音色状态：请通过 查询指定音色 接口，确认音色状态是否为“OK”。

     • 检查账号：声音复刻所使用的音色归属的账号，必须与语音合成时所使用的账号保持一致。

2. 检查 model （模型）与 voice （音色）版本是否匹配：

   v2 模型只能使用 v2 的音色，v1 模型只能使用 v1 的音色，两者不可混用。

Request voice is invalid!

若您使用 语音合成-CosyVoice ，此错误通常是因为未设置音色。请检查是否对 voice 参数赋值。若您使用 WebSocket API ，请参照 API 文档按照正确 JSON 格式配置参数。

-

TimeoutError

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

若您使用 语音合成-CosyVoice ，请检查本地网络、防火墙设置，或更换网络环境或服务器进行测试。

-

-

Cannot resolve symbol 'ttsv2'

若您使用 语音合成-CosyVoice ，出现该问题的原因是 DashScope SDK 版本老旧，请 安装最新版 DashScope SDK 。

-

NO_INPUT_AUDIO_ERROR

-

未检测到有效语音。

若您使用 语音识别-Paraformer 实时语音识别，请通过如下方式排查：

1. 检查是否有音频输入

2. 检查音频格式是否正确

   支持的音频格式：pcm、wav、mp3、opus、speex、aac、amr。

   重要

   对于 opus 和 speex 格式的音频，需要 ogg 封装；对于 wav 格式的音频，需要 pcm 编码。

-

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 录音文件识别，原因是需要下载的文件不存在。

-

FILE_403_FORBIDDEN

-

若您使用 语音识别-Paraformer 录音文件识别，原因是没有权限下载待识别录音。

-

FILE_SERVER_ERROR

-

若您使用 语音识别-Paraformer 录音文件识别，原因是请求的文件所在的服务不可用。

-

AUDIO_DURATION_TOO_LONG

-

若您使用 语音识别-Paraformer 录音文件识别，原因是请求的文件时长超过 12 小时。

建议将音频进行切分，分多次提交识别任务。

# -i input_audio.wav：指定输入文件，即待处理的音频文件input_audio.wav。
# -ss 00:10:00：设置起始时间，表示从原始音频的第10分钟（00:10:00）开始处理。
# -to 5:10:00：设置结束时间，表示处理到原始音频的第5小时10分钟（5:10:00）为止。
# -c copy：指定编解码器选项，copy表示直接复制音频数据，不进行重新编码，从而加快处理速度。
# output_audio.wav：指定输出文件，即生成的音频文件output_audio.wav。
ffmpeg -i input_audio.wav -ss 00:10:00 -to 5:10:00 -c copy output_audio.wav

-

DECODE_ERROR

-

若您使用 语音识别-Paraformer 录音文件识别，原因是检测音频文件信息失败。请确认文件下载链接中文件为支持的音频格式。

-

INTERNAL_ERROR

-

若您使用 语音识别-Paraformer 录音文件识别，则是受机器负载、网络等因素导致的异常，通常为偶发现象。一般重试调用即可恢复，如无法恢复，请联系技术支持人员。

-

InvalidFile.DownloadFailed

The audio file cannot be downloaded.

若您使用 语音识别-Paraformer 录音文件识别，原因是待识别文件下载失败。请检查待识别音频文件 URL 是否可通过公网访问。

-

-

Invalid payload data

若您使用 语音识别/翻译-Gummy 的 WebSocket API，原因是发送给服务端的 JSON 格式有误，请按如下步骤排查：

1. 检查发送 run-task 指令时， payload 中是否有“ "input": {} ”，若无，请添加。

2. 确认在最终是否发送了完整的 finish-task 指令，且是否遵循 finish-task 指令的格式说明进行发送，如果自行发送其他内容，例如“ { "input": { "end_of_stream": true } } ”（自创内容），也可能会提示“Invalid payload data”。

-

-

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

使用 语音识别-Paraformer 或 语音识别/翻译-Gummy 的流式语音识别时，服务返回的识别结果数据量过大。请分段发送待识别音频， 建议每次发送的音频时长约为 100 毫秒，数据大小保持在 1KB 至 16KB 之间。

44

NO_VALID_AUDIO_ERROR

NO_VALID_AUDIO_ERROR

使用 语音识别-Paraformer 或 语音识别/翻译-Gummy 时，待识别音频无效。请检查音频格式、采样率等是否满足要求。

44

ResponseTimeout

Response timeout!

使用 语音识别-Paraformer 时，长时间未向服务器发送音频或者长时间发送静音音频。请将请求参数 heartbeat 设为 true 或及时结束识别任务。

400

InvalidParameter

current user api does not support http call.

Qwen3 开源版模型不支持非流式输出，请使用 流式输出 。

400

InvalidParameter

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

模型仅支持 流式输出 ，请使用流式输出方式调用模型。

400

InvalidParameter

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

接口调用参数不合法。

400

InvalidParameter

This model does not support enable_search.

当前模型不支持联网搜索能力，如需联网搜索，请使用 Qwen 的商业模型。

400

invalid_parameter_error

<400> InternalError.Algo.InvalidParameter: The value of the enable_thinking parameter is restricted to True.

enable_thinking 参数不允许设为 false 。

解决方案：

• 若通过第三方工具调用（如 Cherry Studio），请打开输入框的思考开关。

• 若通过代码调用，请将 enable_thinking 设为 true 。

400

InvalidParameter

暂时不支持当前设置的语种！

使用 Qwen-MT 模型 时传入的 source_lang 或 target_lang 不在 支持的语言 里，请传入语言的英文全拼或语种编码。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: The incremental_output parameter of this model cannot be set to False.

当前模型仅支持增量流式输出，请手动设置 incremental_output 参数为 true 再进行调用。

400

InvalidParameter

Request method 'GET' is not supported.

访问的 URL 不支持 GET 方法。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: 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 不符合规定，请传入 {"type": "json_object"} 或 {"type": "text"} 。

400

InvalidParameter

input must contain file_urls

使用 语音识别-Paraformer 的录音文件识别时，未对请求参数 file_urls 赋值。

400

invalid_parameter_error

<400> InternalError.Algo.InvalidParameter: An error during model pre-process.

原因：传入了错误格式的 content 字段。

解决方案：

• 若通过代码调用，请勿将 content 设置为如[{

  "type": "text",

  "text": "你是谁？"

  }]的 array 类型。

• 若使用 Cline ，请在设置界面单击 MODEL CONFIGURATION ，并勾选 Enable R1 messages format。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: input content must be a string.

使用模型仅支持设定 content 为 string 类型，请勿将 content 设置为如[{

"type": "text",

"text": "你是谁？"

}]的 array 类型

400

APIConnectionError

Connection error.

本地网络问题。通常是因为开启了代理，请关闭或者重启代理。

400

InvalidParameter

parameter.enable_thinking must be set to false for non-streaming calls

原因：使用非流式输出方式调用了思考模式的模型。

解决方案：请参见 快速开始 部分，使用流式输出。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: The thinking_budget parameter must be a positive integer and not greater than xxx

使用 Qwen3 模型时配置的 thinking_budget 参数不在可选范围内，请参见 深度思考 中对应模型的最大思维链长度，并指定为小于该长度的值。

400

invalid_request_error

you must provide a model parameter.

原因：发起请求时没有提供 model 参数。

解决方案：参见 快速开始 部分传入 model 参数。

400

InvalidParameter

Temperature should be in [0.0, 2.0)

temperature 参数设置未在[0.0, 2.0)的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

invalid_request_error

'temperature' must be Float

temperature 参数设置未在[0.0, 2.0)的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

Range of top_p should be (0.0, 1.0]

top_p 参数设置未在(0.0, 1.0]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

invalid_request_error

'top_p' must be Float

top_p 参数设置未在(0.0, 1.0]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

Presence_penalty should be in [-2.0, 2.0]

presence_penalty 参数设置未在 [-2.0, 2.0]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

Range of max_tokens should be [1, 2000]

max_tokens 参数设置未在 [1, 模型最大输出 Token 数]的范围内。模型最大输出 Token 数请参见 模型列表与价格 。

400

InvalidParameter

Range of n should be [1, 4]

n 参数设置未在 [1, 4]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

Range of seed should be [0, 9223372036854775807]

使用 DashScope 方式调用大模型 API 时，seed 参数设置未在 [0, 9223372036854775807]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

invalid_request_error

-1 is lesser than the minimum of 0 - 'seed'

或

'seed' must be Integer

使用 OpenAI 兼容方式调用大模型 API 时，seed 参数设置未在 [0, 2 ³¹ -1]的范围内。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

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 文档 。

400

InvalidParameter

Parameter top_k be greater than or equal to 0

top_k 参数不可以为负数。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

Repetition_penalty should be greater than 0.0

repetition_penalty 参数不可以为负数。参数的取值范围请参见 通义千问 API 文档 。

400

InvalidParameter

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

调用 Embedding 模型时输入内容行数超过模型上限，具体行数限制请参考 Embedding 。

400

InvalidParameter

Range of input length should be [1, xxxx]

原因：调用模型时输入内容长度超过模型上限。

解决方案：

• 若通过代码调用，请控制 messages 数组中的 Token 个数在模型允许范围内；

• 使用对话客户端（如 Chatbox）或阿里云百炼控制台进行连续对话时，每次请求都会附带历史记录，容易超出模型限制。超出限制后，请开启新对话。

模型最大输入 Token 数请参见 模型列表与价格 。

400

InvalidParameter

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

在使用 视觉理解模型 、 全模态（Qwen-Omni）模型 、 音频理解模型 时传入数据的 URL 不符合要求，需要是 http:// 、 https://、 data: 、 file://开头。

如果开头是 data:， 在 Base64 编码数据前需要包含 "base64" ，否则也会报错。

400

InvalidParameter

Input should be a valid dictionary or instance of GPT3Message

messages 字段的构造格式不符合要求，例如括号数量不匹配、缺少必要的键值对等。

400

invalid_request_error

'audio' output only support with stream=true

在使用 （Qwen-Omni）模型 时，未使用流式输出方式。

400

InvalidParameter

Value error, contents is neither str nor list of str

LangChain 框架下调用模型方式错误，请参考 Langchain 开发参考 进行调用。

400

InvalidParameter

Model not exist.

原因：指定的模型名称不存在。

解决方案：可能是 model 参数大小写有误，或阿里云百炼没有您调用的模型。请对照 模型列表与价格 中的模型名称，检查您输入的 model 是否正确。

400

invalid_parameter_error

<400> InternalError.Algo.InvalidParameter: Json mode response is not supported when enable_thinking is true

原因：使用 结构化输出 时开启了模型的思考模式，阿里云百炼模型在思考模式下不支持结构化输出。

解决方案：请将 enable_thinking 设为 false 关闭思考模式。

400

InvalidParameter

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

prompt 和 messages 字段不能都为空。

原因可能是格式错误，例如 通过 HTTP 调用 DashScope 服务 （非 OpenAI 兼容方式）时，messages 需放入 input 对象中，而不是与 model 参数并列。

{
    "model": "指定模型",
    "input": {
        "messages": [
            {"role": "user", "content": "你是谁"},
    "parameters": {
        "result_format": "message"
}

400

InvalidParameter

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

在开启 JSON 结构化输出功能时，未在 System Message 或 User Message 指引模型以 JSON 格式输出，如：“请以 JSON 格式输出。”。

400

InvalidParameter

File [id:file-fe-***********] format is not supported.

Qwen-Long 模型仅限于处理纯文本格式文件，包括 TXT、DOCX、PDF、EPUB、MOBI 及 MD 文件类型。目前不支持图片或扫描文档（因其本质上是图片形式，无法直接提取文本内容）的上传。如需对图片内容进行文本提取、分析和总结，您可以使用 通义千问 VL 模型 。

400

InvalidParameter

Invalid file [id:file-fe-***********].

提供的 file-id 无效，例如输入错误、使用了不属于当前 API Key 所关联阿里云账号的 file-id。您可以通过 查询文件列表接口 确认 file-id 是否有效或重新 上传文件 来获取新的 file_id 后进行调用。

400

InvalidParameter

File [id:file-fe-***********] cannot be found.

仅在 Qwen-Long 模型的对话场景中，在发起对话请求后的极短时间内调用 OpenAI 文件兼容接口删除相关文件时才会出现。请等待模型完成对话后再删除相关文件。

400

InvalidParameter

Too many files provided.

提供的 file-id 数量超限，请确保 file-id 数量小于 100。

400

InvalidParameter

File [id:file-fe-***********] exceeds size limit.

提供的 file-id 文件大小超限，请确保文件小于 150 MB。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: The audio is empty

音频时间过短，导致采样点不足。请增加音频的时间。

400

InvalidParameter

File [id:file-fe-***********] exceeds page limits (15000 pages).

提供的 file-id 文件页数超限，请确保文件页数小于 15000 页。

400

None

File parsing in progress, please try again later.

仅在 Qwen-Long 模型的对话场景中发生，与模型对话所使用的文档正在解析中请稍后再试。

400

None

[] is too short

输入的 messages 为空数组，请添加 message 后再发起请求。

400

InternalError.Algo.InvalidParameter

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

未检测到具有 user 角色的输入内容

• API 调用模型时，未向模型传入 User Message；

• API 调用阿里云百炼工作流应用时，在开始节点中传入的参数，需通过 biz_params 参数传递（而非 user_prompt_params ）。具体用法请参见 传递自定义参数 。

400

InvalidParameter

File [id:file-fe-***********] content blank.

提供的 file-id 文件内容为空，请确保文件内容符合要求。

400

InvalidParameter

Total message token length exceed model limit (10000000 tokens).

输入总长度超过了 10,000,000 Token，请确保 message 长度符合要求。

400

InvalidParameter

Single round file-content exceeds token limit, please use fileid to supply lengthy input.

输入的单条 message 长度超过了 9,000 Token，请 文档上传 。

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.

数据检查错误，输入或者输出包含疑似敏感内容被绿网拦截。

400

bad_response_status_code

<400> InternalError.Algo.InvalidParameter: messages with role "tool" must be a response to a preceeding message with "tool_calls"

在工具调用时没有向 messages 数组添加 Assistant Message。请将模型第一轮响应的 Assistant Message 添加到 messages 数组后再添加 Tool Message。

400

BadRequestException

Invalid part type

仅在 Qwen-Long 模型的对话场景中，Qwen-Long 模型目前暂不支持在对话场景中用户上传的文件类型。

400

InternalError.Algo.InvalidParameter.NotSupportEnableThinking

The model xxx does not support enable_thinking.

当前使用的模型不支持参数 enable_thinking。

Qwen3 模型需要设置 enable_thinking 为 true 来开启思考模式，其它模型不支持此参数。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: The tool call is not supported.

使用的模型不支持传入 tools 参数来使用 function calling，请更换为其它 Qwen 或 DeepSeek 模型。

400

BadRequest.EmptyInput

Required input parameter missing from request.

请求的输入不能为空。

400

BadRequest.EmptyParameters

Required parameter "parameters" missing from request.

请求的参数不能为空。

400

BadRequest.EmptyModel

Required parameter "model" missing from request.

请求输入的模型不能为空。

400

BadRequest.IllegalInput

The input parameter requires json format.

请检查入参数格式，确保符合 API 的要求。

400

InvalidURL

Invalid URL provided in your request.

请求的 URL 错误。

400

InvalidParameter

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

使用通义千问 VL 模型进行视频理解，且以图像列表方式传入时，图像数量不符合要求。详情可参见 视觉理解 。

• Qwen2.5-VL 系列模型：最少传入 4 张图片，最多 512 张图片其他模型：

• 最少传入 4 张图片，最多 80 张图片

400

InvalidParameter

Exceeded limit on max bytes per data-uri item : 10485760'.

Multimodal file size is too large

向 Qwen-VL 模型 、 QVQ 模型 、 Qwen-Omni 模型 传入的本地图像或视频大小不符合要求。

• 传入本地文件：需要保证 Base64 编码后的单个文件小于 10MB。

• 传入文件 URL：传入图像时，单个文件本身的大小不超过 10 MB；传入视频文件时，Qwen2.5-VL 系列模型支持传入的单个视频本身大小不超过 1 GB，其他模型不超过 150 MB。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: Input should be 'Cherry', 'Serena', 'Ethan' or 'Chelsie': parameters.audio.voice

使用 Qwen-Omni 或 Qwen-TTS 时 voice 参数指定错误，请指定为'Cherry', 'Serena', 'Ethan' 或 'Chelsie'中的一个。

400

InvalidParameter

The image length and width do not meet the model restrictions. [absolute aspect ratio must be smaller than 200, got n / m].

The image length and width do not meet the model restrictions. [height:n or width:m must be larger than 10].

The image size is not supported for the data inspection.

传入通义千问 VL 模型的图像尺寸（长度和宽度）不符合模型的要求。

图像尺寸需满足以下要求：

• 图像的宽度和高度均不小于 10 像素。

• 宽高比不应超过 200:1 或 1:200。

400

InvalidParameter

Failed to decode the image during the data inspection.

图像解码失败。

• 确认图像是否有损坏。

• 确认图像格式是否符合要求。

400

InvalidParameter

The file format is illegal and cannot be opened.

The media format is not supported or incorrect for the data inspection.

无法支持的图像文件格式或图像无法打开。

• 确认图像是否损坏。

• 确认文件扩展名和实际格式是否匹配。

• 确认图像格式是否支持，如通义千问 VL 模型仅支持以下图像格式：JPEG、JPG、PNG、BMP、TIFF、TIF、WEBP、HEIC。

• 若使用 临时公网 URL ，检查 HTTP 请求 Header 是否包含必要参数： X-DashScope-OssResourceResolve: enable 。

400

InvalidParameter

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 为 OSS 的内网 URL。由于 OSS 内网与阿里云百炼服务不互通，请勿使用 OSS 内网 URL。

• 提供的图片资源所在的 IP 地址不在中国内地。

  由于网络环境的差异，跨境资源访问可能会受到一定的限制或不稳定因素影响。建议您尽量使用中国内地的资源存储服务，以确保网络连接的稳定性和访问速度。

  你可以使用 IP Address Lookup ，确定 IP 是否位于中国内地。

400

InvalidParameter.DataInspection

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

当前访问的资源无法找到。

• 确认资源的 URL 链接是否正确，如是否缺少协议头 http:// / https:// 。

• 确认该资源是否上传到指定位置。

400

InvalidParameter

url error, please check url！

文件 URL 错误。请提供正确的 URL 或检查该 URL 是否能正常访问。

400

InvalidParameter

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

可能的原因：调用模型时，传入的 OSS 中带签名的文件 URL 已经过期。请确保在文件 URL 的有效期内访问该文件。

400

InvalidParameter

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

使用 DashScope SDK 调用多模态模型时，用户消息中的 content 参数必须使用以下枚举值之一：image、video、audio、text。

400

invalid_value

Invalid value: vide. Supported values are: 'text','image_url','video_url' and 'video'.

使用 OpenAI SDK 调用模型时，content 参数 type 属性的取值不正确。支持的取值有 text、image_url、video 或 video_url。

400

InvalidParameter

Invalid video file.

传入的视频文件无效。

400

InvalidParameter

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

传入通义千问 VL 模型或者 Qwen-Omni 模型的视频时长超过限制：

• Qwen2.5-VL 模型支持的视频时长应在 2 秒至 10 分钟之间。

• 其他通义千问 VL 或 Qwen-Omni 模型支持的视频时长应在 2 秒至 40 秒之间。

400

Arrearage

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

• 可能原因一：阿里云账号因为欠费而被拒绝访问。请前往 费用与成本 页面查看是否欠费或充值。

  模型响应账号余额会有一些时间的延迟，请您等待几分钟后重试。

• 可能原因二：调用 Batch 接口返回该报错，是因为未开通阿里云百炼服务。请前往阿里云百炼控制台的 模型广场 ，免费开通阿里云百炼服务，然后用阿里云百炼的 API KEY 进行调用。

400

ServiceUnavailableError

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

请检查输入内容长度大于 0，并确保参数格式符合 API 文档的要求。

400

UnsupportedOperation

The operation is unsupported on the referee object.

关联的对象不支持该操作（可以根据实际情况修改）。

400

FlowNotPublished

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

流程未发布，请发布流程后再重试。

400

InvalidSchema

Database schema is invalid for text2sql.

请输入数据库 Schema 信息。

400

InvalidSchemaFormat

Database schema format is invalid for text2sql.

输入数据表信息格式异常。

400

FaqRuleBlocked

Input or output data is blocked by faq rule.

命中 FAQ 规则干预模块。

400

CustomRoleBlocked

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

请求或响应内容没有通过自定义策略。

400

InternalError.Algo

Missing Content-Length of multimodal url.

URL 请求的响应头信息缺失 Content-Length 字段。如果问题无法解决，请尝试使用其他图片链接。

400

InternalError.Algo

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

模型服务底层服务器出现错误，请稍后再进行调用尝试。

400

InternalError.Algo.InvalidParameter

Tool names are not allowed to be [search]

MCP Server 的工具名称无法设置为 search，请重新设置。

400

InvalidParameter

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 模型支持的图像 。

400

InvalidParameter

<400> InternalError.Algo.InvalidParameter: tool_choice is one of the strings that should be ["none", "auto"]

发起 工具调用（Function Calling） 时指定的 tool_choice 参数有误，请指定为 "auto"（由大模型自主选择工具）或 "none"（强制不使用工具）。

400

InvalidParameter

The content field is a required field.

使用 Java SDK 调用模型时没有配置 content 参数。

400

invalid_request_error

Payload Too Large.

执行 Batch 任务时，上传的 JSONL 文件大小超出允许的最大限制。

为了顺利完成上传，请检查并确保文件大小符合规定限制，或者考虑将大文件分割成多个较小的文件进行上传。JSONL 文件格式请参考 输入文件格式 。

400

invalid_request_error

Upload file capacity exceed limit.

Upload file number exceed limit.

上传文件失败。说明当前阿里云账号下的阿里云百炼存储空间已满或接近满额，可以通过 删除文件 接口删除不需要的文件以释放空间。

当前阿里云账号下的阿里云百炼存储空间支持的最大文件数为 10000 个，文件总量不超过 100 GB。

400

Index.InvalidParameter

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

调用 SubmitIndexJob 接口时返回此错误，原因是调用 CreateIndex 接口时未指定必传参数 SourceType ：基于给定文档创建知识库时，此参数需传入 DATA_CENTER_FILE ；基于给定类目创建知识库时，此参数需传入 DATA_CENTER_CATEGORY 。详见 CreateIndex 文档。

400

InternalError.Algo.InvalidParameter.NotSupportEnableThinking

The model xxx does not support enable_thinking.

当前使用的模型不支持设定参数 enable_thinking 。

Qwen3 模型需要设置 enable_thinking 为 true 来开启思考模式，其他模型不支持此参数。

400

Throttling.AllocationQuota

您当前的配额为 xxx

xxx 为具体的配额，例如 1001，则其对应错误信息为：您当前的配额为 1000

CosyVoice 声音复刻 音色数量已达限额。可以 删除 一部分音色，或加入 开发者群 申请扩容。

Free allocated quota exceeded.

使用 定制热词（Paraformer） 或 定制热词（Gummy） 时，热词数目已超过上限。

每个账号默认 10 个 （Paraformer 和 Gummy 共用） 热词列表，您可以删除一部分热词，或加入 开发者群 申请扩容。

400

Audio.AudioShortError

valid audio too short!

用于 CosyVoice 声音复刻 的音频时长应尽量控制在 10~15 秒之间。录音时请确保朗读连贯，并包含至少一段超过 5 秒的连续语音。

400

Audio.AudioSilentError

silent audio error

CosyVoice 声音复刻 音频文件为静音或非静音长度过短。用于声音复刻的音频时长应尽量控制在 10~15 秒之间。录音时请确保朗读连贯，并包含至少一段超过 5 秒的连续语音。

400

ClientDisconnect

Client disconnected before task finished!

任务结束前，客户端主动断开了连接。该报错信息在您使用 语音合成-Sambert 、 语音识别/翻译-Gummy 、 语音识别-Paraformer 和 语音合成-CosyVoice 时产生。请检查代码，不要在任务结束前断开和服务端的连接。

401

InvalidApiKey

invalid_api_key

Invalid API-key provided.

Incorrect API key provided.

API Key 填写错误。常见原因为：

• 中国站的 API Key 调用了国际站的服务（base_url 含 -intl）。请访问 阿里云百炼中国站 确认 API Key 属于中国站，并删除请求中 base_url 中的 -intl 。

• 国际站的 API Key 调用了中国站的服务。请访问 阿里云百炼国际站 确认 API Key 属于国际站，并参考 国际站文档 ，修改调用方式。

• 控制台复制的 API Key 可能含前后空格。请在粘贴前检查。

• Cline 等工具未正确适配，请参见 Cline 。

若以上原因均不符合，请重新 获取 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

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.

原因：开启了 免费额度用完即停 ，且免费额度耗尽后发起请求。

控制台免费额度显示有小时级延迟。即使额度已用完，界面仍可能显示剩余额度。

解决方案：如需付费调用，请等待控制台显示免费额度用完后，关闭 免费额度用完即停 按钮。

403

AccessDenied

access_denied

Access denied.

无权访问此 API ，比如不在邀测中。请前往阿里云百炼控制台，在 模型广场 的对应模型卡片下方单击 立即申请 发起测试申请 。

403

App.AccessDenied

App access denied.

无权限访问应用或者模型。

• 仔细确认对访问的业务空间做了访问授权。

• 仔细确认对访问的子账号的做了访问授权。

• 仔细检查应用是否发布。

• 仔细核实传入的 APP ID、API KEY 是否正确。

• 若上述建议都正确，建议刷新数据重新发布再调用，或尝试重新创建智能体。

如果您在使用 Claude Code 时出现此问题，可能是使用了子业务空间的 API Key。目前 Claude Code 只支持默认业务空间的 API Key。

403

Workspace.AccessDenied

Workspace access denied.

无权限访问业务空间的应用或者模型。

403

Model.AccessDenied

Model access denied.

403

AccessDenied.Unpurchased

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

• 您可能还未开通阿里云百炼服务：您需要 注册 或 登录 阿里云账号，然后前往 模型广场 开通模型服务。

• 您可能已开通阿里云百炼服务，请您耐心等待一会后再 查看新人免费额度 。

403

AccessDenied

Current user api does not support asynchronous calls.

接口不支持异步调用。

403

AccessDenied

Invalid according to Policy: Policy expired.

在获取临时公网 URL 时，文件上传凭证已经过期。

请重新调用 文件上传凭证接口 生成新凭证。

404

WorkSpaceNotFound

WorkSpace can not be found.

用户空间信息不存在。

404

model_not_supported

Unsupported model `xxx` for OpenAI compatibility mode.

当前模型不支持以 OpenAI 兼容方式接入您当前使用的接口。请您参见模型官方文档的示例代码。

404

ModelNotFound

model_not_found

Model can not be found.

The model xx does not exist.

The model xx does not exist or you do not have access to it.

• 当前访问的模型不存在。请对照 模型列表与价格 中的模型名称，检查您输入的模型名称（参数 model 的取值）是否正确。

• 您还未开通阿里云百炼服务，您需要前往 模型广场 开通模型服务。

404

NotFound

Not found!

使用 定制热词（Paraformer） 或 定制热词（Gummy） 时，传入的热词 ID 无效或对应热词不存在。请检查：热词 ID 是否正确并参照 API 文档按照正确的方式进行调用。

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

• 请求超时，您可尝试再次发起请求。

• 可能是因为输出内容很长导致超时，您可尝试采用流式输出方式发起请求，具体操作请参见 流式输出 。

  调用通义千问模型时，响应体中会将已生成的内容返回，不再报超时错误。详情请参见 文本生成 。

413

BadRequest.TooLarge

Payload Too Large.

文件大小超出限制，“purpose”参数为“file-extract”时文档不超 150MB、图片不超 20MB；“batch”用途文件不超 500MB。超限时请拆分并分批上传文件。

415

BadRequest.InputDownloadFailed

Failed to download the input file: xxx.

下载输入文件失败，可能是由于下载超时、下载失败或者文件超过限额大小，错误信息可以指出更详细的内容。

415

BadRequest.UnsupportedFileFormat

Input file format is not supported.

输入文件的格式不受支持。

unsupported audio format:xxx

xxx 音频格式，例如 opus，则其对应错误信息为：unsupported audio format:opus

CosyVoice 声音复刻 时，上传的音频格式不符合模型要求。

File format unsupported.

416

BadRequest.ResourceNotExist

The Required resource not exist.

• CosyVoice 声音复刻 更新、查询或删除接口调用时，对应音色不存在。

• 使用 定制热词（Paraformer） 或 定制热词（Gummy） 时，更新、查询或删除接口调用的热词资源不存在。

429

Throttling

Requests throttling triggered.

接口调用触发限流。

429

Throttling

• Too many fine-tune job in running, please retry later.

• Only 20 fine-tune job in running or succeeded allowed per user.

资源的创建触发平台限制。您可以删除不再使用的模型。

429

Throttling.RateQuota

LimitRequests

limit_requests

Requests rate limit exceeded, please try again later.

You exceeded your current requests list

调用频次触发限流，比如每秒钟请求次数。您可以查阅 限流 文档了解对应模型的限流条件。建议等待一段时间后再尝试调用。

429

/

Too many requests in route. Please try again later.

请求过多触发限流，暂时无法处理您的请求，请稍后再进行重试。

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 数。您可以参考 如何计算 Token 数？ 计算您生成的 Token 数。

429

Throttling.Batch

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

Batch 请求过多触发限流，暂时无法处理您的请求，请稍后再进行重试。

429

Throttling.AllocationQuota

Free allocated quota exceeded.

免费额度已经到期或者耗尽，并且该模型未支持计费访问。

429

PrepaidBillOverdue

The prepaid bill is overdue.

业务空间预付费账单到期。

429

PostpaidBillOverdue

The postpaid bill is overdue.

模型推理商品已失效。

429

CommodityNotPurchased

Commodity has not purchased yet.

业务空间未订购。

430

Audio.DecoderError

Decoder audio file failed.

CosyVoice 声音复刻 音频文件解码失败。

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 无法访问，请按照 Q：如何将音频文件以公网可访问的 URL 形式提供？ 中的说明操作后重试。

  • 录音文件时长过长。尽量选择 10~15 秒的录音。录音时请确保朗读连贯，并包含至少一段超过 5 秒的连续语音。

audio preprocess server error

internal unknown error

请检查 CosyVoice 声音复刻 音频文件格式是否符合要求。

Invalid backend response received (missing status name)

使用 语音识别-Paraformer 的录音文件识别的 RESTful API 时，请求参数拼写有误。请参照 API 文档 检查代码。

500

InternalError.Algo

Embedding_pipeline_Error: xxxx

图像或视频预处理出错，请确认上传的图片或视频及请求代码符合要求后重试。

500

InternalError.Algo

Receive batching backend response failed!

服务内部错误，可稍后重试。

500

internal_server_error

Internal server error!

服务器内部报错，可稍后再进行尝试调用。

500

InternalError.Algo

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

内部算法错误。

500

InternalError.Algo

Role must be in [user, assistant]

在使用 Qwen-MT 模型 时，请确保 messages 数组中仅包含一个元素，且该元素必须是用户消息（User Message）。

500

SystemError

system_error

An system error has occured, please try again later.

系统错误。

若您使用 Spring AI Alibaba ，请参照示例代码或说明文档，查看是否代码编写有误，若依然无法确定问题，加入 Spring AI Alibaba 官网 最下方提供的 DING 群，联系开发人员进行定位。

500

internal_server_error

<500> InternalError.Algo: list index out of range

messages 数组最后一位需为 User Message。

500

InternalError.Algo

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

模型生成的 JSON 数据不合法，无法正常发起工具调用。建议更换最新的模型或优化提示词后重试。

500

InternalError.Timeout

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

异步任务从网关提交给算法服务层之后等待时间 3 小时，如果在这期间始终没有结果，则超时。

500

RewriteFailed

Failed to rewrite content for prompt.

调用改写 prompt 的大模型失败。

500

RetrivalFailed

Failed to retrieve data from documents.

文档检索失败。

500

AppProcessFailed

Failed to proceed application request.

应用流程处理失败。

500

ModelServiceFailed

Failed to request model service.

模型服务调用失败。

500

InvokePluginFailed

Failed to invoke plugin.

插件调用失败。

503

ModelUnavailable

Model is unavailable, please try again later.

模型暂时无法提供服务。

503

ModelServingError

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

我们的网络资源目前处于饱和状态，暂时无法处理您的请求，您可以稍后再进行尝试。

NetworkError

network_error

network error

NoApiKeyException: Can not find api-key.

环境变量配置没有生效，您可以重启客户端或 IDE 后重试。更多情况请参考 常见问题 。

ConnectException: Failed to connect to dashscope.aliyuncs.com

请检查本地网络环境是否存在异常，例如因证书问题导致无法访问 HTTPS，防火墙设置有误等情况。建议您更换网络环境或服务器进行测试。

InputRequiredException: Parameter invalid: text is null

若您使用 语音合成-CosyVoice ，此错误通常是由于未发送待合成文本引起的。

请根据以下可能原因进行排查：

1. 参数遗漏：在调用语音合成接口时，可能忘记为 text 参数赋值。

2. 代码异常：某些代码逻辑可能导致对 text 参数的赋值失败。