常见问题

计费方式

按时间计费

可包月预付费

按模型调用量计费

计费公式

费用 = 使用时长 × 实例数量 ×实例单价

支持模型丰富

费用 = 调用消耗量 × 部署后调用单价

单价与模型推理（调用）单价相同

计费说明

适合对大模型推理服务有低延迟、高SLA需求的场景。

适合对模型训练的结果进行快速验证。

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.

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时产生。请检查代码，不要在任务结束前断开和服务端的连接。

400

InvalidURL

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.

图片不可访问或下载的文件格式不支持。当前仅支持JPEG, JPG, PNG, BMP和WEBP。

400

InvalidFile.NoHuman

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

输入图片中没有人。未检测到人脸，请上传请上传单人照。

400

InvalidFile.MultiHuman

The input image has multi human bodies. 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.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.

上传图片的分辨率不得低于400*400，且不得高于7000*7000。

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.FacePose

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

上传图片中人物面部姿态不符合要求（要求面部朝向无严重偏移）。请确保图片中人脸朝向无偏斜。

400

InvalidParameter

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

入参格式不对。

400

InvalidParameter

The style is invalid.

style不在枚举范围内。

400

InvalidURL

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

输入的URL不正确或缺失。

400

InvalidURL

The input audio is longer than 20s.

输入的音频文件超过最大时长20秒。

400

InvalidURL

File size is larger than 15MB.

输入的音频文件超过最大限制15MB。

400

InvalidURL

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

输入的音频格式不合规，当前仅支持wav、mp3格式。

400

InvalidParameter

image format error

图片格式错误，需要是图片url或者base64字符串。

400

InvalidParameter

No messages found in input

请求参数中需要有messages字段。详情参见通义千问-图像编辑。

400

InvalidParameter

Invalid image format or corrupted file

输入图片格式错误或文件损坏。请检查文件是否可正常打开和下载，确保文件完整且格式符合要求。

400

InvalidParameter

download image failed

图片不能下载。请检查文件是否可正常下载。

400

InvalidParameter

messages length only support 1

messages数组长度仅支持 1，即只能传入一条对话消息。详情参见通义千问-图像编辑。

400

InvalidParameter

content length only support 2

content数组长度仅支持为2，即只能传入一组text和image。详情参见通义千问-图像编辑。

400

InvalidParameter

lack of image or text

请求参数缺少image或text字段。详情参见通义千问-图像编辑。

400

DataInspectionFailed

Input xxx data may contain inappropriate content.

输入数据（如提示词或图像）可能包含敏感内容。内容合规检查，请修改输入后重试。

400

DataInspectionFailed

Output data may contain inappropriate content.

输出数据（如提示词或图像）可能包含敏感内容。内容合规检查，请修改输入后重试。

400

IPInfringementSuspect

Input data is suspected of being involved in IP infringement.

输入数据（如提示词或图像）涉嫌知识产权侵权。内容合规检查，请检查输入，确保不包含引发侵权风险的内容。

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.

插件调用失败。

500

InternalError.Algo

inference internal error.

服务异常。请先尝试重试，排除偶发情况。

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 参数的赋值失败。

CLIENT_ERROR

[qwen-tts:]Engine return error code: 411

在进行Qwen-TTS实时语音合成时，选用的模型是qwen-tts-vc-realtime-2025-08-20，音色是默认音色，就会出现该问题，原因是上述模型仅支持复刻音色，不支持其他音色。