本文主要介绍在开发过程中接入阿里云百炼,出现的错误码以及对应的错误原因。
错误码列表
阿里云百炼模型服务的API调用将返回状态码以标识调用结果。通用状态码由阿里云百炼约定,各算法模型还可能在通用状态码的基础上增加自定义的状态码和状态信息。请通过返回结果中的code
和status
字段定位调用成功或失败的详细信息。
HTTP 返回码 | 错误代码 Code | 错误信息 Message (具体信息内容可能跟随场景有所变化) | 含义说明 |
400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | 接口调用参数不合法。 |
400 | InvalidParameter | Either \"prompt\" or \"messages\" must exist and cannot both be none | prompt和messages字段不能都为空。 原因可能是格式错误,例如通过HTTP调用DashScope服务(非OpenAI兼容方式)时,messages需放入input对象中,而不是与model参数并列。
|
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请求的响应头信息缺失 |
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. | 无权限访问业务空间的应用或者模型。
|
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 |
|
|
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 | 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 | 如果失败,内容为失败详细信息,参考错误码表“错误信息”部分,需要注意的是这部分内容可能会随着具体的情况有所不同,可能会输出更加有针对性的内容,不一定和上述码表中的信息完全一致。 |