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

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

错误码列表

HTTP 返回码	错误代码 Code	错误信息 Message	说明
400	InvalidParameter	Required parameter(s) missing or invalid, please check the request parameters.	接口调用参数不合法。
400	APIConnectionError	Connection error.	本地网络问题。通常是因为开启了代理，请关闭或者重启代理。
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	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	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	invalid_request_error	Payload Too Large.	执行Batch任务时，上传的JSONL文件大小超出允许的最大限制。为了顺利完成上传，请检查并确保文件大小符合规定限制，或者考虑将大文件分割成多个较小的文件进行上传。JSONL文件格式请参考输入文件格式。
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	如果失败，内容为失败详细信息，参考错误码表“错误信息”部分，需要注意的是这部分内容可能会随着具体的情况有所不同，可能会输出更加有针对性的内容，不一定和上述码表中的信息完全一致。