错误信息

报错信息：'code': 'Arrearage', 'param': None, 'message': 'Access denied, please make sure your account is in good standing.', 'type': 'Arrearage'}帮我看下为啥

400-InvalidParameter

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

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

解决方案：请将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字符串。常见问题有：多了,、括号未闭合等。可借助阿里云AI助理帮助修复请求体格式。

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是否正确。

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:开头, 在 Base64 编码数据前需要包含"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 模型时，输入不是字符串也不是字符串数组。

解决方案： 请修改输入格式为字符串或字符串列表。

check input data style.

原因： 输入参数不满足入参要求。

解决方案： 请检查并修正输入参数。

An error during model pre-process.

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

解决方案：

• 若通过代码调用，请勿将content设置为如[{"type": "text", "text": "你是谁？"}]的array类型。

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

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

解决方案：

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

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

原因： 阿里云账号因为欠费而被拒绝访问。

解决方案：请前往费用与成本页面查看是否欠费。账号余额有延迟，充值后请等待几分钟后重试。

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

原因： 上传图片中人物姿态不符合要求。

解决方案： 请上传符合要求的图片，头像照要求头部完整可见，半身照要求髋部以上完整可见。

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-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排查。

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）或定制热词（Gummy）时，更新、查询或删除接口调用的热词资源不存在。

400-Throttling.AllocationQuota

您当前的配额为xxx

原因： CosyVoice声音复刻音色数量已达限额。

解决方案： 可以删除一部分音色，或加入开发者群申请扩容。

Free allocated quota exceeded.

原因： 使用定制热词（Paraformer）或定制热词（Gummy）时，热词数目已超过上限（每个账号默认10个，Paraformer和Gummy共用）。

解决方案： 可以删除一部分热词，或加入开发者群申请扩容。

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.

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

解决方案： 请检查内容或调整自定义策略。

401-InvalidApiKey/invalid_api_key

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

原因： API Key 填写错误。

解决方案： 常见原因及解决方案如下：

• 地域不匹配：中国大陆版的 API Key 调用了国际版的服务（base_url 含 -intl），或国际版的 API Key 调用了中国大陆版的服务。请确认 API Key 与服务地域匹配。

• 工具适配问题：第三方工具未正确适配（如 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-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.

原因： 无权访问此 API。

解决方案： 请前往阿里云百炼控制台，在模型广场的对应模型卡片下方单击立即申请发起测试申请。或改用其他模型，例如通义千问或通义万相的文生图模型替代 Flux。

403-AccessDenied.Unpurchased

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

原因： 您可能还未开通阿里云百炼服务。

解决方案： 您需要注册或登录阿里云账号，然后前往模型广场开通模型服务。

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 调用，或者可能存在模型名称拼写错误。

解决方案： 请参考支持的模型，确认支持 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文档按照正确的方式进行调用。

409-Conflict

Model instance xxx already exists, please specify a suffix.

原因： 已存在重名的部署实例。

解决方案：为部署的模型指定不同的后缀名。

429-Throttling

Requests throttling triggered.

原因： 接口调用触发限流。

解决方案： 请降低调用频率或稍后重试。

Too many fine-tune job in running, please retry later. / Only 20 fine-tune job in running or succeeded allowed per user.

原因： 资源的创建触发平台限制。

解决方案： 可以删除不再使用的模型。如需提高并发量或保留更多模型，请发送邮件至modelstudio@service.aliyun.com申请提额。

Too many requests in route. Please try again later.

原因：请求过多触发限流。

解决方案：请稍后重试。

429-Throttling.RateQuota/LimitRequests/limit_requests

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

原因： 调用频率（RPS/RPM）触发限流。

解决方案： 请参考限流，控制调用频率。

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）触发限流。

解决方案： 参考如何计算 Token 数？根据限流规则调整调用策略。

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

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

Internal server error!

原因： 内部算法错误。

解决方案： 请稍后重试。

audio preprocess server error

使用CosyVoice声音复刻：

• 原因：音频文件不规范，比如声音本身有问题，有杂音或者声音忽高忽低。

  解决方案：请参见录音操作指南录音后重试。

• 原因：录音文件URL无法访问，

  解决方案：请按照Q：如何将音频文件以公网可访问的URL形式提供？中的说明操作后重试。

• 原因：录音文件时长过长。

  解决方案：尽量选择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.

原因： 系统错误。

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

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

原因：

• 调用大模型时请求超时，超时报错时间为180秒。

• 使用语音识别（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到环境变量。

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: 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 参数赋值。

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.

原因： 上传文件失败，当前阿里云账号下的阿里云百炼存储空间已满或接近满额。

解决方案： 可以通过删除文件接口删除不需要的文件以释放空间。当前存储空间支持最大文件数为10000个，总量不超过100 GB。

WebSocket 报错

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

原因： 使用语音识别（Paraformer）或语音识别/翻译（Gummy）的流式语音识别时，服务返回的识别结果数据量过大。

解决方案： 请分段发送待识别音频，建议每次发送的音频时长约为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）或语音识别/翻译（Gummy）时，待识别音频无效。 解决方案： 请检查音频格式、采样率等是否满足要求。