Status code reference
If an error occurs during an API call, refer to the table below. It describes the cause of each error and provides a solution.
HttpCode | Error code | Error message | Error message key | Description | Recommended action |
200 | 200 | Success | aca.error.success | Success | |
400 | 400 | Invalid Request | aca.error.invalid.request | Invalid request. This exception is triggered by an incorrect HTTP request header, such as MediaType. | Check that the request header is correct. Refer to the API description in the documentation. |
400 | Invalid Param | aca.error.invalid.param | Invalid parameter. An incorrect parameter exists in the request body. The specific invalid parameter is usually indicated. | Check the request parameters. Refer to the API description in the documentation. | |
400 | Invalid Request Method | aca.error.invalid.request.method | Unsupported request method. For example, this exception is thrown if you use the PUT method to update a role instead of the required POST method. | Check that the request method is correct. Refer to the API description in the documentation. | |
400 | Request Params Unreadable | aca.error.invalid.request.params.unreadable | Unreadable request parameters. The parameters in the request body are invalid, such as an incorrect JSON format. | Check the JSON format in the request body. Refer to the API description in the documentation. | |
400 | Invalid Token | aca.error.invalid.token | Invalid token. | Verify the request token. | |
401 | Data Duplicate | aca.error.data.duplicate | Data redundancy. This exception is triggered if you try to change a username to one that already exists in the system. | Verify the request data. | |
403 | No Permission | aca.error.no.permission | No permission. This occurs when a user tries to operate on a resource without permission. Examples include chatting with a role created by another user that is not public, or logging on to the Stardust platform using an Alibaba Cloud RAM user. | Check if the current account has permission to operate on the specified resource. | |
404 | Not Found | aca.error.notfound | Resource not found. For example, this exception is returned if the `characterId` passed for a fixed role chat does not exist. | Verify the request data. | |
410 | No accept platform usage agreement | aca.error.not.accept.agreement.usage | The platform usage agreement has not been accepted. | Validating the request protocol | |
411 | No Permission to manage character version | aca.error.no.permission.mgmt.version | Versions that do not support permission management roles | If you do not have the required permissions, you can contact the root account administrator. | |
412 | No Permission to open character | aca.error.no.permission.open.character | No permission to make role properties public. | If you do not have the required permissions, contact the administrator of your root account. | |
413 | No Permission to open chat with others | aca.error.no.permission.open.chat | No permission to make the role chat public. | Contact the Alibaba Cloud account owner. | |
414 | No Permission to open api | aca.error.no.permission.open.api | No permission to make the role API public. | Contact the Alibaba Cloud account owner. | |
415 | No Permission to config character knowledge base | aca.error.no.permission.config.kb | No permission to configure the role's knowledge base. | If you do not have the required permission, contact the root account. | |
416 | No Permission to config character image | aca.error.no.permission.config.image | No permission to configure the image generation policy. | Contact the Alibaba Cloud account owner. | |
417 | No Permission to config character asr | aca.error.no.permission.config.asr | No permission to configure the speech generation policy. | Contact the Alibaba Cloud account owner. | |
418 | No Permission to config web search | aca.error.no.permission.config.web.search | You do not have permission to configure the real-name information search. | Contact the Alibaba Cloud account owner. | |
419 | No Permission to config chat description | aca.error.no.permission.config.chat.description | No permission to configure the chat description. | If you lack the required permissions, contact the root account. | |
420 | content contains sensitive words | aca.error.csi.check.failed.content | The input contains sensitive information. This occurs when the user's question triggers a security issue while content moderation is enabled (X-DashScope-DataInspection=true). | Check the request data for sensitive content. | |
420 | Chat content hit security check exceed limitation | aca.error.csi.check.exceed.limit.chat | The number of times chat content has hit the content moderation blacklist or greylist has exceeded the limit. The default limit is 200 times per day. | Check the compliance of the request data. | |
421 | Chat request too frequent | aca.error.chat.request.too.frequently | The same user (same `userProfile.userId` in the PASS API) is chatting with the same role too frequently. This means a new chat request was sent before the previous one received a complete reply. | Reduce the request frequency or contact platform technical support. | |
429 | Request was denied due to output token flow control. | aca.error.chat.gateway.throttling.userTokenLimit | The API call triggered token-based throttling. | Reduce the request frequency or contact platform technical support. | |
429 | Request was denied due to qps flow control. | aca.error.chat.gateway.throttling.userQPSLimit | The API call triggered queries per second (QPS) throttling. | Reduce the request frequency or contact platform technical support. | |
431 | Allocated quota exceeded, please increase your quota limit. | aca.error.llm.quota.exceeded | The chat request was throttled. | Reduce the request frequency or contact technical support. | |
441 | Ram Account | aca.login.ram.disable | RAM users are not allowed to log on. | Contact the Alibaba Cloud account owner. | |
442 | need login | aca.login.invalid.pk | The logon session has expired. | Log on again. | |
461 | Not accept model generated content agreement | aca.error.not.accept.agreement.platform.generated.content | The agreement for model-generated content has not been accepted. | Contact platform technical support. | |
462 | Not approved user | aca.error.not.approved | User is not invited. | Contact platform technical support. | |
471 | LLM request error. | aca.error.llm.request.error | Abnormal model call. This error occurs if the requested model parameters are invalid, such as `topP` >= 1, or if a non-existent model is used. | Verify the request parameters. | |
481 | Character fields hit security check exceed limitation | aca.error.csi.check.exceed.limit.character.field | The number of times role properties have hit the content moderation blacklist or greylist has exceeded the limit. The default limit is 200 times per day. | Check the compliance of the request data. | |
482 | Character create times exceed limitation | aca.error.character.create.times.exceed.limit | The number of role creations has exceeded the limit of 50 per day. | You can check if the data exceeds the limit. | |
483 | character is out | aca.error.character.out | The role has been delisted. | Verify the request data. | |
484 | character is unpublished | aca.error.character.unpublished | The role is not public. | Verify the request data. | |
492 | LLM generated content contains sensitive words | aca.error.csi.check.failed.generated | The model-generated content contains sensitive information. | Check the compliance of the request data and then regenerate the content. | |
499 | user cancel request. The connect has been break! | USER_BREAK_CONNECT | The user disconnected. | Check your network connectivity. | |
500 | 500 | Internal Server Error | aca.error.internal.exception | Internal service error. This error can have multiple causes. Contact platform technical support. | Contact platform technical support. |
501 | Gateway error. | aca.error.gateway.exception | Gateway error. If you encounter this issue, contact platform technical support. | Contact platform technical support. | |
503 | Service is unavailable! | SERVICE_UNAVAILABLE | This may be caused by network fluctuations. If this error occurs frequently, contact platform technical support. | Check your network connectivity, or contact platform technical support. | |
508 | URL security verification failed | aca.check.url.error | URL security verification failed. | Verify the request URL, or contact platform technical support. | |
509 | Unknown system error, please contact with administrator | aca.error.unknown.exception | Unknown system exception. Contact backend technical support. | Contact platform technical support. | |
510 | Send SSE data error. | aca.error.sse.send.exception | Error sending Server-Sent Events (SSE) message. This occurs when the client closes the session before the server-side finishes sending the generated result. | Check your network connectivity, or contact platform technical support. |