返回状态码说明
状态码参考
DashScope灵积模型服务的API调用将返回状态码以标识调用结果。通用状态码由DashScope约定，各算法模型还可能在通用状态码的基础上增加自定义的状态码和状态信息。请通过返回结果中的 code 和 status 字段定位调用成功或失败的详细信息。
下表列出DashScope通用状态码信息。各算法模型自定义的状态码信息则可在模型详情页进行查找。
重要通义千问模型API目前处于"申请体验"阶段，请点击此处申请。
在您的账号未申请体验或申请未通过时，调用通义千问模型API将返回错误状态码。
Code | Status | 可能的原因 | 含义说明 |
400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters.(可根据实际情况修改) | 接口调用参数不合法 |
429 | Throttling | Requests throttling triggered. | 接口调用触发限流 |
429 | Throttling.RateQuota | Requests rate limit exceeded, please try again later. | 调用频次触发限流，比如 QPM |
429 | Throttling.AllocationQuota | Allocated quota exceeded, please increase your quota limit. | 一段时间调用量触发限流，比如 TPM |
500 | InternalError | 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.(可根据实际情况修改) | 内部算法错误 |
400 | DataInspectionFailed | Input or output data may contain sensitive 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. | 请求输入的模型不能为空 |
500 | SystemError | An system error has occured, please try again later. | 系统错误 |
401 | InvalidApiKey | Invalid API-key provided. | 请求中的 ApiKey 错误 |
408 | RequestTimeOut | Request timed out, please try again later. | 请求超时 |
400 | InvalidURL | Invalid URL provided in your request. | 请求的 URL 错误 |
400 | AccessDenied | Access denied. | 无权访问此 API，比如不在邀测中 |
400 | AccessDenied.Unpurchased | Access to model denied. Please make sure you are eligible for using the model. | 客户没有开通此商品 |
400 | Arrearage | Access denied, plesase make sure your account is in good standing. | 客户账户因为欠费而访问被拒绝 |
413 | BadRequest.TooLarge | Payload Too Large | 接入层网关返回请求体过大错误，错误如果是由mse网关层直接拦截，则没有 code，并且 message 不能自定义。如果是restful网关拦截返回code。 |
500 | InternalError.Timeout | An internal timeout error has occured during execution, please try again later or contact service support. | 异步任务从网关提交给算法服务层之后等待时间 3 小时，如果 3 小时始终没有结果，则超时。 |
400 | UnsupportedOperation | The operation is unsupported on the referee object. | 关联的对象不支持该操作（可以根据实际情况修改） |
注：http 返回码在某些特定协议之下可能不存在
返回字段参考
DashScope灵积模型服务除状态码外还会返回请求的一些细节信息。一个示例的调用可能如下所示：
{
"status_code": 200,
"request_id": "54dc32fd-968b-4aed-b6a8-ae63d6fda4d4",
"output": {
"text": "这是一个示例。"
},
"code": "",
"message": "",
"usage": {
"computation_time": 1230,
"input_tokens": 7,
"output_tokens": 78
}
}- 返回参数说明
返回参数 | 类型 | 说明 |
status_code | int | 200（HTTPStatus.OK）表示请求成功，否则表示请求失败，可以通过code获取错误码，通过message字段获取错误详细信息。 |
request_id | string | 系统对一次API调用赋予的唯一标识。当排查问题的时候，开发者可以将 request_id 进行反馈以定位某次调用。 |
output | object | 调用API指定的算法模型所返回的AI处理输出。 |
usage | object | 调用API后模型服务产生的计量数据。 |
code | string | 如果失败表示错误码，参考错误码表。 |
message | string | 如果失败，内容为失败详细信息。 |