Updated on 2026-11-17 GMT+08:00

Error Codes

When you call MaaS APIs (Endpoint, MaaS Call Statistics, and Querying ModelArts Real-Time Services) or model APIs, you may encounter errors. To troubleshoot the issue, refer to Table 1 for general APIs or Table 2 for model APIs.

Table 1 General API error codes

HTTP Status Code

Error Code

Error Message

Description

Handling

400

ModelArts.0104

Parameter %s value is invalid.

The value of parameter %s is incorrect.

Failed to verify the description or tag parameter.

Modify the input parameter.

400

ModelArts.0104

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

Invalid parameter. The number of IP addresses in the whitelist cannot exceed 100.

The number of IP addresses in the whitelist exceeds 100.

Reduce the number of IP addresses in the whitelist to less than 100.

400

ModelArts.6692

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

Maximum number of API keys reached (%d).

The number of API keys exceeds the upper limit.

Delete some API keys and try again.

400

ModelArts.6691

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

An API key with the same name already exists under the same tenant.

Duplicate tag.

Modify the tag and try again.

400

ModelArts.0104

The API key does not exist or is invalid.

The specified API key ID does not exist.

Check whether the API key ID is correct.

400

ModelArts.0104

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

Incorrect IP address whitelist format. Check the following data: %s.

The IP address whitelist contains invalid IPv4 addresses.

Check the IP address whitelist format and confirm every entry is a valid IPv4 address.

400

ModelArts.0104

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

Invalid parameter. Duplicate IP address: %s. Check the parameter.

The IP address whitelist contains duplicate IP addresses.

Remove duplicate IP addresses.

400

ModelArts.0104

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

Invalid parameter. The mask of the IP address in CIDR format is invalid. IP address: %s

The mask of the IP address in CIDR format is invalid.

Check whether the CIDR format and mask are correct.

400

ModelArts.0104

CreateCustomEndpointReq.endpoint_name is a required field

The custom endpoint name is mandatory.

Check whether the custom endpoint name is specified.

400

ModelArts.6271

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

The custom endpoint name has been used (including deleted endpoints). To ensure the uniqueness of the bill, use a different name.

Check whether the endpoint name has been used. If yes, use a different one.

400

ModelArts.6274

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

The name of the custom endpoint is invalid. Enter 1 to 64 characters. Only letters, digits, underscores (_), hyphens (-), and periods (.) are allowed.

Check the format of the custom endpoint name.

400

ModelArts.6291

CustomEndpointNotFound

The custom endpoint does not exist.

Check whether the custom endpoint has been created.

400

ModelArts.6297

Custom endpoint number exceed quota

The number of custom endpoints exceeds the quota.

Delete unnecessary custom endpoints and try again.

400

ModelArts.6299

Custom endpoint id is required

The custom endpoint ID is missing.

Check whether the custom endpoint ID is correct.

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.

Operation failed. You can create a custom endpoint only when MaaS gateway mounting is enabled or the authentication type is no authentication.

  • In Service Call Settings, set Authentication Mode to None.
  • In Network Settings, enable Public Network Access and Private Network Connection Approval.

401

ModelArts.8503

No permission to create modelarts custom endpoints

You do not have the permission to create a custom endpoint for ModelArts real-time services.

Check whether the account permission meets the requirements.

400

ModelArts.2115

Invalid JSON request body

Invalid JSON request body.

The invalid request body has been modified based on the error message.

400

ModelArts.6298

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

Security check for parameter (%s) failed. Check for special characters.

Check whether your parameters contain insecure characters.

Table 2 Error codes

HTTP Status Code

Error Code

Error Message

Description

Measure

400

ModelArts.81118

Image dimensions %s exceed pixel limit (maxPixels=%s, maxDimension=%s).

The image pixel size exceeds the limit.

Reduce the image size and try again.

400

ModelArts.81001

Inference failed: Unknown error: Tokenizer encode failed.

Example: The prompt length 151499 must less than the maximum input length 129024. Request failed with status: 400 BAD_REQUEST.

The parameter value in the request exceeds its allowed value range.

Check the parameter value range in the MaaS API Calling Specifications for the corresponding model type, modify the request, and try again.

400

ModelArts.81001

Failed to format request body, %s is empty.

Example: Failed to format request body, model is empty.

Mandatory parameters are missing in the request.

Modify the request by referring to MaaS API Call Specifications and try again.

400

ModelArts.81001

Failed to format request body, %s is %s, not one of %s.

Example: Failed to format request body, messages[1].role is SYSTEM, not one of ['system', 'user', 'assistant', 'function', 'tool'].

The request contains invalid parameters, which do not meet the enumerated value requirements.

Modify the request by referring to MaaS API Call Specifications and try again.

400

ModelArts.81001

Invalid request header x-span-id, max length is 64.

The log call chain (x-span-id) in the request header cannot exceed 64 characters.

Change the log call chain ID in the request header and try again.

400

ModelArts.81002

Failed to get the authorization header.

The authorization parameter in the request header is either empty or lacks the Bearer prefix.

Enter the correct authentication information in the request header by referring to MaaS API Call Specifications and try again.

401

ModelArts.81003

Invalid authorization header.

Failed to parse the authentication information in the request header.

Enter the correct authentication information in the request header by referring to MaaS API Call Specifications and try again.

401

ModelArts.81015

Invalid client ip %s, rejected by api key ip allowlist setting.

Failed to verify the source IP address whitelist after the API key is parsed.

On the API Key Management page, check the API key permission settings.

401

ModelArts.81015

Invalid model %s, rejected by api key model allowlist setting.

Failed to verify the model version whitelist after the API key is parsed.

On the API Key Management page, check the API key permission settings.

401

ModelArts.81015

Invalid custom endpoint %s, rejected by api key custom endpoint allowlist setting.

Failed to verify the endpoint whitelist after the API key is parsed.

On the API Key Management page, check the API key permission settings.

403

ModelArts.81011

May contain sensitive information, please try again.

The input or output content may contain sensitive information.

Modify the request and try again.

403

ModelArts.81017

The account is blocked for this model version

The account is not allowed to call the model.

The account may be banned due to violations. Submit a service ticket.

403

ModelArts.81109

No permission query task %s.

You do not have the permission to query the asynchronous task.

Check whether the input task_id is correct.

403

ModelArts.81112

The resource is no longer available.

The resource is no longer available.

Check whether the account is normal and whether the account is in arrears. To continue using the account, try subscribing to the service again.

404

ModelArts.81009

Invalid model.

The model specified by the model parameter in the request is not found.

Refer to the API document, modify the request, and try again.

404

ModelArts.81016

The model %s is not available with api url %s.

The model called by the request does not support the API call.

Different APIs support different models. For details, see MaaS API Call Specifications.

404

ModelArts.81108

Task %s does not exist.

The asynchronous task to be queried is not found.

Check whether the input task_id is correct.

413

ModelArts.81113

Invalid request body, exceeds the maximum size %s.

The request body is too large, exceeding the upper limit of the server.

Modify the request and try again.

429

ModelArts.81101

Too many requests, the rate limit is %s times per second.

The request rate exceeds the QPS limit.

Too frequent calls. Try again later.

429

ModelArts.81101

Too many requests, the rate limit is %s times per minute.

The request rate exceeds the RPM limit.

Too frequent calls. Try again later.

429

ModelArts.81114

Too many requests, the rate limit is %s tokens per minute.

The request rate exceeds the TPM limit.

Too frequent calls. Try again later.

429

ModelArts.81111

The model TPM limit has been significantly exceeded. Please reduce the request rate and retry later.

A sharp increase in the number of requests or input/output tokens triggered the platform's stability protection.

Control the calling frequency and try again later.

429

ModelArts.81116

The QPS rate limit has been exceeded due to scaling protection. Please reduce your request rate and try again later.

The request growth is throttled during resource pool expansion.

Control the calling frequency and try again later.

500

ModelArts.81102

An unexpected exception occurred. Please try again.

Internal system error.

Submit a service ticket.

503

ModelArts.81104

Backend server error.

The server failed to process the request.

Submit a service ticket.

504

ModelArts.81110

Server process timeout.

The server response times out.

Try again later.