All Products
Search
Document Center

Error codes

Last Updated: Sep 18, 2020

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.

Note

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

240999DEFAULT_ERRORThe error message returned because a default internal error occurred.
240001NUI_CONFIG_INVALIDThe error message returned because the configuration file is invalid.
240002ILLEGAL_PARAMThe error message returned because a specified parameter is invalid.
240003ILLEGAL_INIT_PARAMThe error message returned because an initialization parameter is invalid.
240004NECESSARY_PARAM_LACKThe error message returned because a required parameter is missing.
240005NULL_PARAM_ERRORThe error message returned because a parameter is left empty.
240006NULL_LISTENER_ERRORThe error message returned because the listener callback is not specified.
240007NULL_DIALOG_ERRORThe error message returned because no valid dialog instance is specified. This is generally an internal status error.
240008NULL_ENGINE_ERRORThe error message returned because no valid engine instance is specified. Check whether the engine initialization is successful.
240009ILLEGAL_DATAThe 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

240010ILLEGAL_REENTRANTThe error message returned because you used the SDK after you exited the client.
240011SDK_NOT_INITThe error message returned because the SDK is not properly initialized.
240012SDK_ALREADY_INITThe error message returned because the SDK is repeatedly initialized.
240013DIALOG_INVALID_STATEThe error message returned because the internal dialog instance is in an abnormal state.
240014STATE_INVALIDThe error message returned because the SDK is in an abnormal state.
240015ILLEGAL_FUNC_CALLThe 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

240030CREATE_NUI_ERRORThe error message returned because the engine failed to be created.
240031TEXT_DIALOG_START_FAILThe error message returned because the text comprehension task failed to be started.
240032TEXT_CANCEL_START_FAILThe error message returned because the text comprehension task failed to be canceled.
240033WUW_DUPLICATEThe error message returned because you specified repeated dynamic wake-up words.

Client engine errors

Error code

Error message

Description

240040CEI_INIT_FAILThe error message returned because the client engine failed to be initialized.
240041CEI_SET_PARAM_FAILThe error message returned because an engine parameter failed to be set.
240042CEI_COMPILE_GRAMMER_FAILThe error message returned because the code syntax failed to be compiled.
240043CEI_STOP_FAILThe error message returned because the client engine failed to stop the recognition task.
240044CEI_CANCEL_FAILThe error message returned because the client engine failed to cancel the recognition task.
240045CEI_UNLOAD_KWS_FAILThe error message returned because the client engine failed to cancel the specified wake-up words.
240046GET_WUW_ERRORThe 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

240080ENGINE_INIT_TIMEOUTThe error message returned because the request to initialize the engine timed out.
240081SET_PARAM_TIMEOUTThe error message returned because the request to set parameters timed out.
240082SET_WUW_TIMEOUTThe error message returned because the request to set wake-up words timed out.
240083SELECT_RECORDER_TIMEOUTThe error message returned because the request to select the recording device timed out.
240084STOP_TIMEOUTThe error message returned because the request to terminate the dialog timed out.
240085ASR_ENGINE_STOP_TIMEOUTThe error message returned because the request to disable the engine timed out.
240086UNLOAD_DYNAMIC_WUW_TIMEOUTThe error message returned because the request to cancel the dynamic wake-up words timed out.
240087ADD_DYNAMIC_WUW_TIMEOUTThe error message returned because the request to add the dynamic wake-up words timed out.
240100WAIT_TIMEOUTThe error message returned because the engine request timed out.
240101HANDLE_API_TIMEOUTThe error message returned because the API request timed out.

Network errors

Error code

Error message

Description

240060CREATE_DA_REQUEST_ERRORThe error message returned because the dialog assistant failed to be created.
240061START_DA_REQUEST_ERRORThe error message returned because the dialog assistant failed to be started.
240062DEFAULT_NLS_ERRORThe 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.
240063SSL_ERRORThe error message returned because the Secure Sockets Layer (SSL) certificate failed to be created.
240064SSL_CONNECT_FAILEDThe error message returned because the SSL connection failed.
240065HTTP_CONNECT_FAILEDThe error message returned because the HTTP connection failed.
240066DNS_FAILEDThe error message returned because the Domain Name System (DNS) resolution failed.
240067CONNECT_FAILEDThe error message returned because the socket connection failed.
240068SERVER_NOT_ACCESSThe error message returned because the server cannot be accessed.
240069SOCKET_CLOSEDThe error message returned because the socket is closed.
240070AUTH_FAILEDThe error message returned because the authentication failed.
240071HTTPDNS_FAILEDThe 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

240090UPDATE_CONTEXT_TIMEOUTThe error message returned because the request to update the client timed out.
240091CONNECTION_TIMEOUTThe error message returned because the network connection timed out.
240092PARTIAL_ASR_TIMEOUTThe error message returned because the request to obtain the intermediate recognition result timed out.
240093ASR_TIMEOUTThe error message returned because the request to obtain the final recognition result timed out.
240094DIALOG_TIMEOUTThe error message returned because the request to obtain the dialog processing result timed out.
240095WWV_TIMEOUTThe 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

40000001The authentication failed.Check whether the token expires or is invalid.
40000002The message is invalid.Check whether the message that is sent meets the requirement.
403The token expires or is invalid.1. Check whether the token expires.2. Check whether the token is valid.
40000004The idle connection timed out.Check whether no data has been sent to the server for 10 consecutive seconds.
40000005The 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.
40000000A client error occurred. This is the default client error code.Check the error message or submit a ticket.
41010120The client timed out.The client has not sent audio data for 10 or more consecutive seconds.
50000000A 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.
50000001An internal call error occurred.If the error code is occasionally returned, ignore it. If the error code is returned multiple times, submit a ticket.
52010001An internal call error occurred.If the error code is occasionally returned, ignore it. If the error code is returned multiple times, submit a ticket.
40010001The method is not supported.If you use the SDK, submit a ticket.
40010002The instruction is not supported.If you use the SDK, submit a ticket.
40010003The instruction is invalid.If you use the SDK, submit a ticket.
40010004The client is disconnected.Check whether the client is disconnected before the server completes the requested task.
40010005The task is in an abnormal state.Check whether the instruction is supported in the current task status.
40020105The specified appkey is invalid.Resolve the route to check whether the application exists.
40020106The 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.
40020503Resource Access Management (RAM) user authentication fails.Use your Alibaba Cloud account to authorize the RAM user to access the POP API.
41040201The client has not sent data for 10 consecutive seconds.Check the network connection or whether no business data needs to be sent.
41040202The 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.
41040203The 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.
41040204The client calls methods in an invalid order.Check whether the client calls the relevant method to send a request before it calls other methods.
41040205The specified MAXSILENCE_PARAM parameter is invalid.Check whether the value of the MAXSILENCE_PARAM parameter is in the range of 200 to 2000.
41050008The 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.
51040101An internal error occurred on the server.Resolve the error based on the error message.
51040102Reserved.N/A
51040103The real-time speech recognition service is unavailable.Check whether the number of real-time speech recognition tasks exceeds the upper limit.
51040104The request for real-time speech recognition timed out.Check the logs of the real-time speech recognition service.
51040105The 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.
51040106The 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.