更新时间:2026-11-17 GMT+08:00

错误码

当您调用MaaS 通用API(自定义接入点、调用统计、以及查询AI开发平台相关接口)或模型API时,可能会出现接口错误;为了帮助您快速定位问题,通用API请参考表1,模型API请参考表2。

表1 通用API错误码

HTTP状态码

错误码

错误信息

说明

处理措施

400

ModelArts.0104

Parameter %s value is invalid.

参数 %s 值错误。

描述或标签参数校验失败。

修改入参。

400

ModelArts.0104

Invalid parameter, error: ip whitelist number can not be more than 100.

参数无效,问题:IP白名单数量不能超过100条。

IP白名单数量超过100条。

请将IP白名单数量缩减至100条以内。

400

ModelArts.6692

The number of APIKEYs has reached the limit (%d).

APIKEY 数量已达上限(%d)

APIKEY数量超过限制。

删除一部分APIKEY后重试。

400

ModelArts.6691

An APIKEY with the same name already exists within the same tenant.

同租户内已存在相同名字的 APIKEY。

标签重复。

修改标签后重试。

400

ModelArts.0104

The API key does not exist or is invalid.

指定的API Key ID不存在。

请检查API Key ID是否正确。

400

ModelArts.0104

IP whitelist format error, please check, ip: %s.

IP白名单格式不对,请检查,异常数据: %s。

IP白名单中存在非合法IPv4地址。

请检查IP白名单格式,确保为合法IPv4。

400

ModelArts.0104

Invalid parameter, error: duplicate ip: %s, please check.

参数无效,问题:重复ip: %s, 请检查。

IP白名单中存在重复IP。

请去除重复的IP地址。

400

ModelArts.0104

Invalid parameter, error: invalid CIDR format, ip: %s.

参数无效,问题:CIDR格式IP的掩码不合法, ip: %s

CIDR格式IP的掩码不合法。

请检查CIDR格式及掩码是否正确。

400

ModelArts.0104

CreateCustomEndpointReq.endpoint_name is a required field

自定义接入点名称为必填字段。

请检查自定义接入点名称是否填写。

400

ModelArts.6271

Custom endpoint name has already been used (including deleted access points). To ensure billing uniqueness, please use a different name.

自定义接入点名称已被使用过(包含已删除的接入点),为保证账单唯一性,请使用不同的名称。

请检查接入点名称是否已经被使用并更换。

400

ModelArts.6274

Custom endpoint name is invalid. Enter 1 to 64 characters. Only letters, digits, point(.), underscores (_), and hyphens (-) are allowed

自定义接入点名称命名无效。请输入1到64位只包含中英文、数字、下划线(_)、中划线(-)和英文半角句号(.)的名称。

请检查自定义接入点名称格式。

400

ModelArts.6291

CustomEndpointNotFound

自定义接入点不存在。

请确认自定义接入点是否已创建。

400

ModelArts.6297

Custom endpoint number exceed quota

自定义接入点数量超出配额。

请删除不用的自定义接入点再创建。

400

ModelArts.6299

Custom endpoint id is required

缺少自定义接入点ID。

请检查自定义接入点ID是否正确。

400

ModelArts.6613

Operation failed. The online service status needs to have the 'Mount to MAAS Gateway' switch turned on or the authentication method set to 'No Authentication' in order to create custom endpoint.

操作失败,在线服务状态需要打开挂载到MaaS网关开关或认证方式为无认证时才可以创建自定义接入点。

  • 在“服务调用配置”中,“认证方式”选择“无认证”。
  • 在“网络配置”中,打开“外网访问”和“内网连接审批”开关。

401

ModelArts.8503

No permission to create modelarts custom endpoints

没有创建AI开发平台ModelArts-在线服务自定义接入点的权限。

请检查账号权限是否满足。

400

ModelArts.2115

Invalid JSON request body

非法JSON请求体。

已依照错误信息修改非法请求体。

400

ModelArts.6298

Parameter (%s) security check failed, please check for special characters.

参数(%s)安全校验失败,请检查特殊字符。

请检查您的参数是否存在不安全字符。

表2 错误码

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调用规范中报错参数的取值范围,更改请求后重试。

400

ModelArts.81001

Failed to format request body, %s is empty.

示例:Failed to format request body, model is empty.

请求缺少必要参数。

请查阅MaaS API调用规范,更改请求后重试。

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调用规范,更改请求后重试。

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调用规范,在请求头中填入正确鉴权信息后重试。

401

ModelArts.81003

Invalid authorization header.

请求头中的鉴权信息解析失败。

请查阅MaaS API调用规范,在请求头中填入正确鉴权信息后重试。

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.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调用规范,不同的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.

服务端响应超时。

请稍后重试。