错误码_大模型服务平台百炼(Model Studio)-阿里云帮助中心

本文介绍在开发过程中接入阿里云百炼时出现的错误码以及对应的错误原因。

错误码列表

HTTP 返回码	错误代码 Code	错误信息 Message	说明
-	-	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 作为明文写入代码中（不建议）。
400	InvalidParameter	Required parameter(s) missing or invalid, please check the request parameters.	接口调用参数不合法。
400	APIConnectionError	Connection error.	本地网络问题。通常是因为开启了代理，请关闭或者重启代理。
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]	调用模型时输入内容长度超过模型上限，具体限制请参考模型列表。
400	InvalidParameter	Input should be a valid dictionary or instance of GPT3Message	messages 字段的构造格式不符合要求，例如括号数量不匹配、缺少必要的键值对等。
400	InvalidParameter	Value error, contents is neither str nor list of str	LangChain框架下调用模型方式错误，请参考Langchain开发参考进行调用。
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	File [id:file-fe-***********] exceeds page limits (15000 pages).	提供的file-id文件页数超限，请确保文件页数小于15000页。
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.	输入的单条messag长度超过了9,000 Token，请通过file-id传入文档信息。
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	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	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).	使用通义千问VL模型进行视频理解，且以图像列表方式传入时，图像数量不符合要求。最少需要传入4张图片，最多可传入80张图片。详情可参见使用通义千问VL模型进行视频理解。
400	InvalidParameter	Exceeded limit on max bytes per data-uri item : 10485760'. Multimodal file size is too large.	传入图像的大小超过了10 MB。请确保传入通义千问VL模型的图像小于10 MB。
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].	传入通义千问VL模型的图像尺寸（长度和宽度）不符合模型的要求。图像尺寸需满足以下要求：图像的宽度和高度均不小于10像素。宽高比不应超过200:1或1:200。
400	InvalidParameter	The file format is illegal and cannot be opened.	图像文件格式非法，无法打开。通义千问VL模型支持的图像格式如下：BMP、DIB、ICNS、ICO、JPEG、JPEG2000、PNG、SGI、TIFF、WEBP。
400	InvalidParameter	Failed to download multimodal content. Download the media resource timed out during the data inspection process.	无法下载多模态文件或者下载超时。有以下两种可能的原因：网络原因，请检查您的网络连接是否正常。该文件的URL为OSS的内网URL。由于OSS内网与百炼服务不互通，请勿使用OSS内网URL。
400	InvalidParameter	Don't have authorization to access the media resource during the data inspection process.	该媒体文件没有访问权限。可能的原因：调用模型时，传入的OSS中带签名的文件URL已经过期。请确保在文件URL的有效期内访问该文件。
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模型的视频时长超过限制，支持的视频时长应在2秒至40秒之间。
400	Arrearage	Access denied, please make sure your account is in good standing.	可能原因一：阿里云账号因为欠费而被拒绝访问。请前往费用与成本页面查看是否欠费或充值。模型响应账号余额会有一些时间的延迟，请您等待几分钟后重试。可能原因二：调用Batch接口返回该报错，是因为未开通百炼服务。请前往百炼控制台的模型广场，免费开通百炼服务，然后用百炼的API KEY进行调用。
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`字段。如果问题无法解决，请尝试使用其他图片链接。查看`Content-Length`字段打开浏览器（如Chrome或Firefox）。打开开发者工具（通常按F12或右键选择“检查”）。切换到Network标签。将图片的URL输入到地址栏并访问。找到对应的请求，查看Headers部分，在“响应头”（Response Headers）部分中查找Content-Length字段
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模型支持的图像。查看`Content-Type`字段打开浏览器（如Chrome或Firefox）。打开开发者工具（通常按F12或右键选择“检查”）。切换到Network标签。将图片的URL输入到地址栏并访问。找到对应的请求，查看Headers部分，在“响应头”（Response Headers）部分中查找Content-Type字段。
400	invalid_request_error	Payload Too Large.	执行Batch任务时，上传的JSONL文件大小超出允许的最大限制。为了顺利完成上传，请检查并确保文件大小符合规定限制，或者考虑将大文件分割成多个较小的文件进行上传。JSONL文件格式请参考输入文件格式。
400	invalid_request_error	Upload file capacity exceed limit.	上传文件失败。说明当前阿里云账号下的百炼存储空间已满或接近满额，可以通过删除文件接口删除不需要的文件以释放空间。当前阿里云账号下的百炼存储空间支持的最大文件数为10000个，文件总量不超过100 GB。
401	InvalidApiKey invalid_api_key	Invalid API-key provided. Incorrect API key provided.	请求中的 ApiKey 错误。
403	AccessDenied access_denied	Access denied.	无权访问此 API，比如不在邀测中。请前往百炼控制台，在模型广场的对应模型卡片下方单击立即申请发起测试申请。
403	Workspace.AccessDenied	Workspace access denied.	无权限访问业务空间的应用或者模型。如果调用子业务空间的应用，请参考业务空间。如果调用子业务空间的模型，请参考子业务空间的模型调用。您也可以改为使用主账号的API KEY，主账号具有所有业务空间的权限。
403	Model.AccessDenied	Model access denied.	子账号无权限访问业务空间的模型。请确认以下步骤：调用时，是否传入了业务空间标识（目前子账号无法访问默认业务空间的应用或模型）。是否已对子账号访问的业务空间做了授权。是否对访问的业务空间做了模型的访问授权。具体详情请参考文档子业务空间的模型调用的前提条件。
403	AccessDenied.Unpurchased	Access to model denied. Please make sure you are eligible for using the model.	您可能还未开通百炼服务：您需要注册或登录阿里云账号，然后前往模型广场开通模型服务。您可能已开通百炼服务，请您耐心等待一会后再查看新人免费额度。
404	WorkSpaceNotFound	WorkSpace can not be found.	用户空间信息不存在。
404	ModelNotFound model_not_found	Model can not be found. The model xx does not exist.	当前访问的模型不存在。
404	ModelNotFound model_not_found	The model xx does not exist or you do not have access to it.	您还未开通百炼服务，您需要前往模型广场开通模型服务。
408	RequestTimeOut	Request timed out, please try again later. Response timeout!	请求超时，您可尝试再次发起请求。可能是因为输出内容很长导致超时，您可尝试采用流式输出方式发起请求，具体操作请参流式输出。
413	BadRequest.TooLarge	Payload Too Large.	接入层网关返回请求体过大错误，如果错误是由MSE网关层直接拦截，则没有 code，并且 message 不能自定义。如果是RESTful网关拦截，则返回code。
415	BadRequest.InputDownloadFailed	Failed to download the input file: xxx.	下载输入文件失败，可能是由于下载超时、下载失败或者文件超过限额大小，错误信息可以指出更详细的内容。
415	BadRequest.UnsupportedFileFormat	Input file format is not supported.	输入文件的格式不受支持。
429	Throttling	Requests throttling triggered.	接口调用触发限流。
429	Throttling.RateQuota	Requests rate limit exceeded, please try again later.	调用频次触发限流，比如每秒钟请求次数。您可以查阅限流文档了解对应模型的限流条件。建议等待一段时间后再尝试调用或申请提高限额。
429	Throttling.AllocationQuota	Allocated quota exceeded, please increase your quota limit.	一段时间调用量触发限流，比如每分钟生成Token数。
429	LimitRequests limit_requests	You exceeded your current requests list	超出调用限制，您需等到不满足限流条件时才能再次调用，部分模型支持申请提高限额，具体请查看限流文档。
429	Throttling.AllocationQuota	Free allocated quota exceeded.	免费额度已经到期或者耗尽，并且该模型未支持计费访问。如果是qwen-vl-v1、qwen-vl-chat-v1模型额度耗尽，建议使用qwen-vl-max、qwen-vl-plus等模型，详情请查看视觉理解文档。
429	PrepaidBillOverdue	The prepaid bill is overdue.	业务空间预付费账单到期。
429	PostpaidBillOverdue	The postpaid bill is overdue.	模型推理商品已失效。
429	CommodityNotPurchased	Commodity has not purchased yet.	业务空间未订购。
500	InternalError internal_error	An internal error has occured, please try again later or contact service support.	内部错误。
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.	系统错误。
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.	模型暂时无法提供服务。
	NetworkError network_error	Can not find api-key.	环境变量配置没有生效，您可以重启客户端或IDE后重试。更多情况请参考常见问题。

返回字段参考

阿里云百炼模型服务在访问失败的情况下，除HTTP状态码外还会返回错误的细节信息，一个访问失败示例的调用可能有如下所示返回：

{
  	"request_id": "54dc32fd-968b-4aed-b6a8-ae63d6fda4d5",
  	"code": "InvalidApiKey",
  	"message": "The API key in your request is invalid."
}

返回参数说明

返回参数	类型	说明
HTTP请求返回码	integer	200（HTTPStatus.OK）表示请求成功，否则表示请求失败，可以通过code获取错误码，通过message字段获取错误详细信息。
request_id	string	系统对一次API调用赋予的唯一标识。当排查问题的时候，开发者可以将request_id进行反馈以定位某次调用。
code	string	如果失败表示错误码，参考错误码表“错误代码”部分。
message	string	如果失败，内容为失败详细信息，参考错误码表“错误信息”部分，需要注意的是这部分内容可能会随着具体的情况有所不同，可能会输出更加有针对性的内容，不一定和上述码表中的信息完全一致。