This topic describes the error codes and error messages that may be returned during the use of Intelligent Speech Interaction to facilitate troubleshooting.
Description
An error code may be returned by the SDK or the server.
Error codes returned by the SDK:
These error codes may be generated during the use of the Intelligent Speech Interaction SDK. The SDK returns an error code in a callback.
Error codes returned by the server:
If a DEFAULT_NLS_ERROR or HTTP_SERVER_ERROR event is returned, an error occurred during the service use. The status parameter in the header object of the event displays the error code.
The error codes and error messages described in this topic apply to the short sentence recognition and real-time speech recognition services.
Successful requests
Error code | Error message | Description |
---|---|---|
0 | SUCCESS | The task is successful. |
Configuration or Parameter errors
Error code | Error message | Description |
---|---|---|
240999 | DEFAULT_ERROR | The error message returned because a default internal error occurred. |
240001 | NUI_CONFIG_INVALID | The error message returned because the configuration file is invalid. |
240002 | ILLEGAL_PARAM | The error message returned because a specified parameter is invalid. |
240003 | ILLEGAL_INIT_PARAM | The error message returned because an initialization parameter is invalid. |
240004 | NECESSARY_PARAM_LACK | The error message returned because a required parameter is missing. |
240005 | NULL_PARAM_ERROR | The error message returned because a parameter is left empty. |
240006 | NULL_LISTENER_ERROR | The error message returned because the listener callback is not specified. |
240007 | NULL_DIALOG_ERROR | The error message returned because no valid dialog instance is specified. This is generally an internal status error. |
240008 | NULL_ENGINE_ERROR | The error message returned because no valid engine instance is specified. Check whether the engine initialization is successful. |
240009 | ILLEGAL_DATA | The error message returned because the URL of the audio data is invalid or the size of the audio data exceeds the upper limit. |
Status errors related to the SDK
Error code | Error message | Description |
---|---|---|
240010 | ILLEGAL_REENTRANT | The error message returned because you used the SDK after you exited the client. |
240011 | SDK_NOT_INIT | The error message returned because the SDK is not properly initialized. |
240012 | SDK_ALREADY_INIT | The error message returned because the SDK is repeatedly initialized. |
240013 | DIALOG_INVALID_STATE | The error message returned because the internal dialog instance is in an abnormal state. |
240014 | STATE_INVALID | The error message returned because the SDK is in an abnormal state. |
240015 | ILLEGAL_FUNC_CALL | The error message returned because the SDK is not used in a valid mode. |
System errors
Error codes | Error message | Description |
---|---|---|
240020 | MEM_ALLOC_ERROR | The error message returned because memory resources failed to be allocated. |
240021 | FILE_ACCESS_FAIL | The error message returned because the file failed to be accessed. |
240022 | CREATE_DIR_ERROR | The error message returned because the storage directory failed to be created. |
Internal SDK call errors
Error code | Error message | Description |
---|---|---|
240030 | CREATE_NUI_ERROR | The error message returned because the engine failed to be created. |
240031 | TEXT_DIALOG_START_FAIL | The error message returned because the text comprehension task failed to be started. |
240032 | TEXT_CANCEL_START_FAIL | The error message returned because the text comprehension task failed to be canceled. |
240033 | WUW_DUPLICATE | The error message returned because you specified repeated dynamic wake-up words. |
Client engine errors
Error code | Error message | Description |
---|---|---|
240040 | CEI_INIT_FAIL | The error message returned because the client engine failed to be initialized. |
240041 | CEI_SET_PARAM_FAIL | The error message returned because an engine parameter failed to be set. |
240042 | CEI_COMPILE_GRAMMER_FAIL | The error message returned because the code syntax failed to be compiled. |
240043 | CEI_STOP_FAIL | The error message returned because the client engine failed to stop the recognition task. |
240044 | CEI_CANCEL_FAIL | The error message returned because the client engine failed to cancel the recognition task. |
240045 | CEI_UNLOAD_KWS_FAIL | The error message returned because the client engine failed to cancel the specified wake-up words. |
240046 | GET_WUW_ERROR | The error message returned because the client engine failed to obtain the specified wake-up words. |
Errors related to audio data
Error code | Error message | Description |
---|---|---|
240050 | SELECT_RECORDER_ERROR | The error message returned because the recording device is not properly selected. |
240051 | UPDATE_AUDIO_ERROR | The error message returned because the audio data failed to be pushed to the server. The general cause is that the size of the audio data exceeds the upper limit. |
240052 | MIC_ERROR | The error message returned because the microphone has not captured any audio data for 2 consecutive seconds. |
Errors related to request timeout
Error code | Error message | Description |
---|---|---|
240080 | ENGINE_INIT_TIMEOUT | The error message returned because the request to initialize the engine timed out. |
240081 | SET_PARAM_TIMEOUT | The error message returned because the request to set parameters timed out. |
240082 | SET_WUW_TIMEOUT | The error message returned because the request to set wake-up words timed out. |
240083 | SELECT_RECORDER_TIMEOUT | The error message returned because the request to select the recording device timed out. |
240084 | STOP_TIMEOUT | The error message returned because the request to terminate the dialog timed out. |
240085 | ASR_ENGINE_STOP_TIMEOUT | The error message returned because the request to disable the engine timed out. |
240086 | UNLOAD_DYNAMIC_WUW_TIMEOUT | The error message returned because the request to cancel the dynamic wake-up words timed out. |
240087 | ADD_DYNAMIC_WUW_TIMEOUT | The error message returned because the request to add the dynamic wake-up words timed out. |
240100 | WAIT_TIMEOUT | The error message returned because the engine request timed out. |
240101 | HANDLE_API_TIMEOUT | The error message returned because the API request timed out. |
Network errors
Error code | Error message | Description |
---|---|---|
240060 | CREATE_DA_REQUEST_ERROR | The error message returned because the dialog assistant failed to be created. |
240061 | START_DA_REQUEST_ERROR | The error message returned because the dialog assistant failed to be started. |
240062 | DEFAULT_NLS_ERROR | The error message returned because an error occurred on the server. Note: This error also generates an error code that is returned by the server. For more information, see the Error codes returned by the server table. |
240063 | SSL_ERROR | The error message returned because the Secure Sockets Layer (SSL) certificate failed to be created. |
240064 | SSL_CONNECT_FAILED | The error message returned because the SSL connection failed. |
240065 | HTTP_CONNECT_FAILED | The error message returned because the HTTP connection failed. |
240066 | DNS_FAILED | The error message returned because the Domain Name System (DNS) resolution failed. |
240067 | CONNECT_FAILED | The error message returned because the socket connection failed. |
240068 | SERVER_NOT_ACCESS | The error message returned because the server cannot be accessed. |
240069 | SOCKET_CLOSED | The error message returned because the socket is closed. |
240070 | AUTH_FAILED | The error message returned because the authentication failed. |
240071 | HTTPDNS_FAILED | The error message returned because the connection between the server and the client by using the specified IP address failed. |
Errors related to network timeout
Error code | Error message | Description |
---|---|---|
240090 | UPDATE_CONTEXT_TIMEOUT | The error message returned because the request to update the client timed out. |
240091 | CONNECTION_TIMEOUT | The error message returned because the network connection timed out. |
240092 | PARTIAL_ASR_TIMEOUT | The error message returned because the request to obtain the intermediate recognition result timed out. |
240093 | ASR_TIMEOUT | The error message returned because the request to obtain the final recognition result timed out. |
240094 | DIALOG_TIMEOUT | The error message returned because the request to obtain the dialog processing result timed out. |
240095 | WWV_TIMEOUT | The error message returned because the request to obtain the wake-up result of the server timed out. |
Error codes returned by the server
If the client receives an EVENT_ASR_ERROR event, and the error code and error message returned by the SDK are 240062 and DEFAULT_NLS_ERROR respectively, the status parameter in the header object of the event displays the error code that is returned by the server.
Error code | Cause | Solution |
---|---|---|
40000001 | The authentication failed. | Check whether the token expires or is invalid. |
40000002 | The message is invalid. | Check whether the message that is sent meets the requirement. |
403 | The token expires or is invalid. | 1. Check whether the token expires.2. Check whether the token is valid. |
40000004 | The idle connection timed out. | Check whether no data has been sent to the server for 10 consecutive seconds. |
40000005 | The number of requests exceeds the upper limit. | Check whether the number of concurrent connections or the queries per second (QPS) exceeds the upper limit. If the number of concurrent connections exceeds the upper limit, we recommend that you upgrade Intelligent Speech Interaction from the trial edition to Commercial Edition. If you have upgraded the service to Commercial Edition, we recommend that you purchase more resources for higher concurrency. |
40000000 | A client error occurred. This is the default client error code. | Check the error message or submit a ticket. |
41010120 | The client timed out. | The client has not sent audio data for 10 or more consecutive seconds. |
50000000 | A server error occurred. This is the default server error code. | If the error code is occasionally returned, ignore it. If the error code is returned multiple times, submit a ticket. |
50000001 | An internal call error occurred. | If the error code is occasionally returned, ignore it. If the error code is returned multiple times, submit a ticket. |
52010001 | An internal call error occurred. | If the error code is occasionally returned, ignore it. If the error code is returned multiple times, submit a ticket. |
40010001 | The method is not supported. | If you use the SDK, submit a ticket. |
40010002 | The instruction is not supported. | If you use the SDK, submit a ticket. |
40010003 | The instruction is invalid. | If you use the SDK, submit a ticket. |
40010004 | The client is disconnected. | Check whether the client is disconnected before the server completes the requested task. |
40010005 | The task is in an abnormal state. | Check whether the instruction is supported in the current task status. |
40020105 | The specified appkey is invalid. | Resolve the route to check whether the application exists. |
40020106 | The specified appkey and token do not match. | Check whether the appkey of the application is valid and belongs to the same Alibaba Cloud account as the token. |
40020503 | Resource Access Management (RAM) user authentication fails. | Use your Alibaba Cloud account to authorize the RAM user to access the POP API. |
41040201 | The client has not sent data for 10 consecutive seconds. | Check the network connection or whether no business data needs to be sent. |
41040202 | The client sends data at a high transmission rate and consumes all resources of the server. | Check whether the client sends data at an appropriate transmission rate, for example, at the real-time factor of 1:1. |
41040203 | The client sends audio data in an invalid audio coding format. | Convert the audio coding format of audio data to a format supported by the SDK. |
41040204 | The client calls methods in an invalid order. | Check whether the client calls the relevant method to send a request before it calls other methods. |
41040205 | The specified MAXSILENCE_PARAM parameter is invalid. | Check whether the value of the MAXSILENCE_PARAM parameter is in the range of 200 to 2000. |
41050008 | The specified sampling rate does not match that of the selected model. | Check whether the audio sampling rate specified for the service call matches the audio sampling rate of the automatic speech recognition (ASR) model that is bound to the application in the console. |
51040101 | An internal error occurred on the server. | Resolve the error based on the error message. |
51040102 | Reserved. | N/A |
51040103 | The real-time speech recognition service is unavailable. | Check whether the number of real-time speech recognition tasks exceeds the upper limit. |
51040104 | The request for real-time speech recognition timed out. | Check the logs of the real-time speech recognition service. |
51040105 | The real-time speech recognition service failed to be called. | Check whether the real-time speech recognition service is enabled and whether the port works properly. |
51040106 | The load balancing of the real-time speech recognition service failed and the client failed to obtain the IP address of the real-time speech recognition service. | Check whether the real-time speech recognition server in the configured virtual private cloud (VPC) works properly. |