# 错误码
在调用MaaS模型服务时，可能出现的错误码及相关信息如下。
表1错误码 
| HTTP状态码 | 错误码              | 错误信息                                                                                                                                                                                                                                                               | 描述                                                 | 处理措施                                                                                                                |
|:---|:---|:---|:---|:---|
| 400      | ModelArts.81118    | Image dimensions %s exceed pixel limit (maxPixels=%s, maxDimension=%s).                                                                                                                                                                                               | 图片像素尺寸超限                                            | 请缩小图片尺寸后重试                                                                                                          |
| 400    | ModelArts.81001   | Inference failed: Unknown error: Tokenizer encode failed. 示例：the prompt length 151499 must less than the maximum input length 129024.Request failed with status: 400 BAD_REQUEST.        | 请求中的参数超出其取值范围。                                    | 请根据模型类型查看对应类型的[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)中报错参数的取值范围，更改请求后重试。 |
| 400    | ModelArts.81001    | Failed to format request body, %s is empty. 示例：Failed to format request body, model is empty.                                                                                           | 请求缺少必要参数。                                            | 请查阅[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)，更改请求后重试。                    |
| 400      | ModelArts.81001  | Failed to format request body, %s is %s, not one of %s. 示例：Failed to format request body, messages\[1\].role is SYSTEM, not one of \['system', 'user', 'assistant', 'function', 'tool'\]. | 请求存在非法参数，不符合枚举值要求。                                 | 请查阅[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)，更改请求后重试。                     |
| 400     | ModelArts.81001  | Invalid request header x-span-id, max length is 64.                                                                                                                                                                                                                   | 请求头中的日志调用链（x-span-id），最大不能超过64位。                   | 更改请求头日志调用链ID后重试。                                                                                                    |
| 400     | ModelArts.81002  | Failed to get the authorization header.                                                                                                                                                                                                                              | 请求头中authorization为空，或者authorization格式不是Bearer开头。 | 请查阅[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)，在请求头中填入正确鉴权信息后重试。             |
| 401    | ModelArts.81003   | Invalid authorization header.                                                                                                                                                                                                                                       | 请求头中的鉴权信息解析失败。                                      | 请查阅[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)，在请求头中填入正确鉴权信息后重试。             |
| 401      | ModelArts.81015   | Invalid client ip %s, rejected by api key ip allowlist setting.                                                                                                                                                                                                     | API Key解析后，校验来源IP白名单失败。                            | 请在"API Key管理"页面，检查API Key权限设置。                                                                                      |
| 401      | ModelArts.81015   | Invalid model %s, rejected by api key model allowlist setting.                                                                                                                                                                                                      | API Key解析后，校验模型版本白名单失败。                          | 请在"API Key管理"页面，检查API Key权限设置。                                                                                      |
| 401     | ModelArts.81015 | Invalid custom endpoint %s, rejected by api key custom endpoint allowlist setting.                                                                                                                                                                                  | API Key解析后，校验自定义接入点白名单失败。                         | 请在"API Key管理"页面，检查API Key权限设置。                                                                                      |
| 403     | ModelArts.81004  | Invalid request because you do not have access to it.                                                                                                                                                                                                                 | 尚未开通调用的预置服务。                                     | 请先[开通预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html)。                                  |
| 403     | ModelArts.81006    | The resource is frozen.                                                                                                                                                                                                                                             | 预置服务处于冻结状态。                                      | 请检查账号状态是否正常，是否存在欠费等情况。                                                                                             |
| 403    | ModelArts.81011   |  May contain sensitive information, please try again.                                                                                                                                                                                                          | 输入或输出内容可能包含敏感信息。                                 | 请更改请求后重试。                                                                                                            |
| 403        | ModelArts.81017   | The account is blocked for this model version                                                                                                                                                                                                                           | 账号被禁止调用该模型。                                      | 账号可能存在违规封禁，请提交工单处理。                                                                                                 |
| 403    | ModelArts.81109 | No permission query task %s.                                                                                                                                                                                                                                         | 无权限查询该异步任务。                                       | 检查传入的task_id是否正确。                                                                                                    |
| 403     | ModelArts.81112 | The resource is no longer available.                                                                                                                                                                                                                                  | 资源已不再可用。                                        | 请检查账号状态是否正常，是否存在欠费等情况；如需继续使用，可尝试重新开通。                                                                             |
| 404    | ModelArts.81009   | Invalid model.                                                                                                                                                                                                                                                     | 不存在请求中的model参数指定的模型。                              | 请查阅API文档，更改请求后重试。                                                                                                   |
| 404      | ModelArts.81016    | The model %s is not available with api url %s.                                                                                                                                                                                                                       | 请求调用的模型，未支持该API调用。                                  | 请查阅[MaaS API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-017.html)，不同的API支持的模型不同。                |
| 404     | ModelArts.81108    | Task %s does not exist.                                                                                                                                                                                                                                               | 未找到需要查询的异步任务。                                    | 检查传入的task_id是否正确。                                                                                                   |
| 413     | ModelArts.81113    | Invalid request body, exceeds the maximum size %s.                                                                                                                                                                                                                   | 请求体过大，超过服务端最大限制。                                    | 请更改请求后重试。                                                                                                          |
| 429   | ModelArts.81101    | Too many requests, the rate limit is %s times per second.                                                                                                                                                                                                           | 请求量超过QPS限制。                                      | 控制调用频率，请稍后重试。                                                                                                       |
| 429      | ModelArts.81101    | Too many requests, the rate limit is %s times per minute.                                                                                                                                                                                                              | 请求量超过RPM限制。                                         | 控制调用频率，请稍后重试。                                                                                                         |
| 429       | ModelArts.81114   | Too many requests, the rate limit is %s tokens per minute.                                                                                                                                                                                                           | 请求量超过TPM限制。                                      | 控制调用频率，请稍后重试。                                                                                                        |
| 429     | ModelArts.81111     | The model TPM limit has been significantly exceeded. Please reduce the request rate and retry later.                                                                                                                                                                | 请求数或输入输出Token数激增，触发平台稳定性保护。                         | 控制调用频率，请稍后重试。                                                                                                     |
| 429     | ModelArts.81116  | The QPS rate limit has been exceeded due to scaling protection，please reduce your request rate and try again later.                                                                                                                                                  | 平台资源池扩容期间，请求数增长保护.                                | 控制调用频率，请稍后重试。                                                                                                       |
| 500     | ModelArts.81102   | An unexpected exception occurred. Please try again.                                                                                                                                                                                                                | 系统内部异常。                                           | 请提交工单处理。                                                                                                            |
| 503      | ModelArts.81104   | Backend server error.                                                                                                                                                                                                                                                | 服务器处理出现错误。                                         | 请提交工单处理。                                                                                                            |
| 504     | ModelArts.81110    | Server process timeout.                                                                                                                                                                                                                                               | 服务端响应超时。                                          | 请稍后重试。                                                                                                             |
   
