API reference

General-purpose error codes

Speech synthesis/Long-text speech synthesis error codes

Speech synthesis/Offline speech synthesis

• SDK-related

  Status code	Status message	Cause	Solution
  140000	TTS_CREATE_FAILED	Engine initialization failed.	The resource path is incorrect or a resource file is abnormal. This fault is often accompanied by the error code TTS_ASSETPATH_INVALID. Review the log to confirm. Ensure the provided resource path is valid and all resource files are complete.
  140001	TTS_ENGINE_INVALID	The engine is not initialized.	The current TTS instance is not created. Check if the initialization API has been called.
  140002	TTS_TEXT_ERROR	The text is invalid, for example, empty.	Check the SDK log to confirm that the file is invalid. Ensure that the input text is valid.
  140003	TTS_MALLOC_FAILED	Memory allocation failed.	Out of memory. Ensure enough memory is available.
  140005	TTS_ASSETPATH_INVALID	The resource path is empty.	The resource path is incorrect or a resource file is abnormal. Check the logs to confirm the fault. Ensure the provided resource path is valid and all resource files are complete.
  140006	TTS_HANLDE_INVALID	The processing thread does not exist.	You can release TTS and then retry.
  140007	TTS_CREATE_HANLDE_FAILED	Failed to create the processing thread.	Check the error message in the log to identify the problem.
  140008	TTS_AUTH_FAILED	Authentication failed. The SDK cannot be used.	Check that the akId, akSecret, and appkey are correct. Review the error message in the log for details. The issue may be that offline authentication is not enabled or that your quota is exhausted.
  140011	TTS_OPERATE_INVALID	Invalid operation.	The current processing thread is in an invalid state. This can occur if a call, such as `pause`, is made before initialization. Ensure that calls are valid for the current state.
  140012	TTS_OPEN_FILE_FAILED	Failed to open the file.	Failed to open the wav debug file or the log file. Check the error message in the log for details.
  140013	TTS_STATE_INVALID	State machine verification failed.	The method call is invalid for the current state machine. This can occur if a method, such as `pause`, is called before initialization. Ensure that method calls are valid for the current state.
  140014	TTS_SYNTHESIZER_INIT_ERROR	Synthesizer initialization failed.	Synthesizer creation failed, mainly due to out of memory.
  140015	TTS_SYNTHESIZER_RELEASE_ERROR	Synthesizer release failed.	The synthesizer failed to release. Check the logs to pinpoint the cause.
  140016	TTS_SYNTHESIZER_FAILED	Synthesis failed.	A state fault occurred during pre-playback. Check the logs to pinpoint the cause.
  140017	TTS_WAIT_TIMEOUT	Timeout exit.	If a timeout occurs while waiting for a status, check the logs for details.
  140018	TTS_CLOSED	The TTS part of the code was not compiled.	The current SDK does not include the TTS feature. Switch to the correct SDK.

• Parameter configuration-related

  Status code	Status message	Cause	Solution
  140100	TTS_PARAM_INVALID	Invalid parameter.	An invalid input parameter was provided during initialization or when setting parameters. For example, the workspace, callback, taskId, or text is empty. Check the logs to locate the specific error.
  140101	TTS_PARAM_VALUE_INVALID	Invalid parameter value.	Invalid input parameter. Check the logs to pinpoint the error.
  140102	TTS_CFG_OPEN_FAILED	Failed to open the configuration file.	The resource path is incorrect or the resource file is abnormal. Check the log to confirm. Ensure the resource path is valid and all resource files are complete.

• Audio processing

  Status code	Status message	Cause	Solution
  140200	TTS_AM_CREATE_FAILED	Player creation failed.	Creation of the SDK's internal audio manager failed.
  140210	TTS_AM_OPEN_FAILED	Player open failed.	The SDK internal audio manager failed to open. Check the logs to pinpoint the issue.
  140210	TTS_DECODER_INIT_FAILED	Audio decoder initialization failed.	The audio decoder, possibly an MP3 decoder, failed to initialize. Check the logs to pinpoint the cause.
  140211	TTS_DECODER_MALLOC_FAILED	Audio decoder failed to allocate memory.	Out of memory. Ensure enough memory is available.
  140212	TTS_DECODER_INPUT_TOO_MANY	Too much data was input at once and will be discarded.	Check the log to identify the specific issue. The maximum data size for a single input is 2000.
  140213	TTS_DECODER_OUTPUT_TOO_MANY	Too much data was output, exceeding the cache, and will be lost.	Check the logs for detailed information.
  140220	TTS_AP_INIT_FAILED	Audio processing unit (audioplayer) failed to open.	This error is typically returned with other AP ErrorCodes. Check the logs for more details.
  140221	TTS_AP_START_FAILED	Error starting ap.	Check the logs to pinpoint the issue.
  140222	TTS_AP_MALLOC_FAILED	Audioplayer failed to allocate memory.	Out of memory. Ensure there is enough memory to run.
  140231	TTS_BGM_DECODE_INVALID	Decoder initialization failed.	Check the logs to confirm if the decoder is initialized.
  140233	TTS_BGM_MALLOC_FAILED	Memory allocation failed.	Out of memory. Ensure there is enough memory to run.
  140237	TTS_BGM_PARAM_INVALID	Background music parameter setting error.	Confirm the parameter settings are correct. Check the log to find the problem. Look for the bgm value:.

• Cache-related

  Status code	Status message	Cause	Solution
  140300	TTS_CACHE_INIT_FAILED	Failed to initialize cache.	This error is often accompanied by the TTS_CACHE_PATH_INVALID error code. This may indicate an invalid storage path. Check the logs for details.
  140302	TTS_CACHE_CMD_ERROR	The cache command is not standard.	Check the returned error message and log to pinpoint the fault.
  140308	TTS_CACHE_PATH_INVALID	Failed to create the cache path.	Check the returned error message and log to locate the fault.
  140309	TTS_CACHE_LIST_CREATE_FAILED	Failed to create the cache list.	Check the returned fault message and log for details.
  140311	TTS_CACHE_TOO_MANY	Too much cache.	View the logs for details.
  140312	TTS_CACHE_PARAM_INVALID	Parameter error.	Check the returned error message and log for details.
  140313	TTS_CACHE_RECORDING_OPEN_FAILED	Error opening local file.	The file permissions or path might be incorrect. Check the logs for details.

• Font delivery-related

  Status code	Status message	Cause	Solution
  140351	TTS_FONT_INITLIST_FAILED	Initialize the fontlist manager.	Out of memory. Ensure there is enough memory to run.
  140352	TTS_FONT_INITLIST_INVALID	The fontlist manager is not initialized.	Out of memory. Ensure sufficient memory is available to run.
  140353	TTS_FONT_CMD_INVALID	The command format is incorrect.	Check the returned fault messages and logs to identify the issue.
  140354	TTS_FONT_RESPONSE_ERROR	The server returned an incorrect format.	Check the returned error messages and logs to pinpoint the issue.
  140350	TTS_FONT_RESPONSELIST_ERROR	The fontlist request to the server returned an incorrect format.	Check the returned error message and log to locate the fault.
  140356	TTS_FONT_GET_FONTLIST_FAILED	Failed to get the fontlist.	Check the returned error messages and logs to pinpoint the error.
  140358	TTS_FONT_LOCALMSG_ERROR	Failed to parse the local list file.	You can check the returned error messages and logs to pinpoint the problem.
  140359	TTS_FONT_LOCALFILE_ERROR	Failed to save the current list file.	Check the returned error messages and logs to pinpoint the problem.
  140360	TTS_FONT_CLOUDMSG_ERROR	Failed to parse the cloud list.	Check the returned error messages and logs to locate the problem.

• Local engine-related

  Status code	Status message	Cause	Solution
  140900	TTS_LOCAL_CRE_ENGINE_ERROR	Local engine initialization failed.	An internal error occurred in the local DPI engine. Check other error messages in the log to diagnose the fault.
  140901	TTS_LOCAL_ENGINE_INVALID	The local engine is not initialized.	Check if TTS is initialized. Review the returned error messages and logs for details.
  140902	TTS_LOCAL_ASSET_ERROR	Local resource verification failed.	The local engine failed to validate the resource path. Check the log for details.
  140903	TTS_LOCAL_CRE_TASK_ERROR	Failed to create a local task.	You can check the logs to locate the specific issue.
  140905	TTS_LOCAL_START_FAILED	Failed to start local synthesis.	View the logs to pinpoint the issue.
  140906	TTS_LOCAL_OPERATION_FAILED	Local operation failed, for example, the local task does not exist or there is a default error.	View the logs to pinpoint details.
  140907	TTS_LOCAL_SWITCH_FONT_FAILED	Failed to switch speaker.	Review the logs for details.
  140908	TTS_LOCAL_GET_SAMPLERATE_FAILED	Failed to get the speaker's sample rate.	Check the logs to pinpoint the issue.
  140909	TTS_LOCAL_ADD_FRONT_END_FAILED	Failed to add speaker.	Check the logs for details.
  140910	TTS_LOCAL_VOICE_PATH_INVALID	The local speaker file does not exist or file authentication failed.	Check the logs to pinpoint the cause.
  140911	TTS_LOCAL_VOICE_MISMATCH	Local speaker file mismatch.	Check the logs for details.

• Cloud engine-related

  Status code	Status message	Cause	Solution
  141000	TTS_CLOUD_CREATE_FAILED	Cloud engine initialization failed.	View the logs for detailed information.
  141004	TTS_CLOUD_START_FAILED	Cloud request failed.	This issue is typically caused by a network connection failure or invalid parameters for the Appkey, Token, or URL. Check the logs to pinpoint the exact cause.
  141007	TTS_CLOUD_NETWORK_BROKEN	The network is poor.	If the network connection is poor, switch to a different network environment and try again.
  141008	TTS_CLOUD_SSL_CONNECT_FAILED	SSL connection failed. Check whether the sent parameters are correct.	SSL connection failed. Check the send parameters. Review the logs for details.
  141009	TTS_CLOUD_HTTP_CONNECT_FAILED	HTTP connection failed. Check whether the sent parameters are correct.	HTTP connection failed. Check the sent parameters. Review the logs for details.
  141010	TTS_CLOUD_DNS_FAILED	Connection failed, DNS failed.	Connection failed. DNS failed. Check that the domain name resolution is correct. For more details, see the logs.
  141011	TTS_CLOUD_URL_INVALID	The URL is invalid.	The URL is invalid. Ping the URL and port to confirm they are reachable. Check the logs for details to locate the issue.
  141012	TTS_CLOUD_PROTOCOL_ERROR	Cloud protocol error.	Cloud protocol error. Check the logs for details.
  141013	TTS_CLOUD_PARAMETERS_ERROR	Parameter error.	Cloud parameter error. Check the log for details.
  141014	TTS_CLOUD_UNKNOWN_WS_HEAD_TYPE	WebSocket uses an unknown header type.	This is a known issue with older clients. Upgrade to the latest version.

• Server-side status codes

  Status code	Status message	Cause	Solution
  144001	TTS_CLOUD_AUTH_FAILED	Identity authentication failed.	Check whether the token used is correct and whether it has expired.
  144002	TTS_CLOUD_INVALID_MESSAGE	Invalid message.	Check whether the sent message meets the requirements.
  144003	TTS_CLOUD_INVALID_TOKEN	The token has expired or the parameter is invalid.	First, check whether the token used has expired. Then, check whether the parameter value is set reasonably.
  144004	TTS_CLOUD_WAIT_TIMEOUT	Idle timeout.	Confirm whether data has not been sent to the server for a long time (more than 10 seconds).
  144005	TTS_CLOUD_EXCEED_CONCURRENCY	Too many requests.	Check whether the number of concurrent connections or requests per second has been exceeded. If the concurrency limit is exceeded, upgrade from the Free Edition to the commercial version, or scale out the concurrency resources for the commercial version.
  144006	TTS_CLOUD_DEFAULT_ERROR	Uncategorized error returned by the cloud.	For example, an invalid model ID was used. Check the log for details.
  144100	TTS_CLOUD_INVALID_INTERFACE	The interface is not supported.	An unsupported operation was used.
  144101	TTS_CLOUD_UNSUPPORTED_ORDER	Unsupported instruction.	An unsupported instruction was used.
  144102	TTS_CLOUD_INVALID_ORDER	Invalid instruction.	The instruction format is incorrect.
  144103	TTS_CLOUD_CLIENT_DISCONNECT	The client disconnected prematurely.	Check whether the connection was closed before the request was completed normally.
  144200	TTS_CLOUD_INVALID_APPKEY	The application does not exist.	Check whether the application AppKey is correct and whether it belongs to the same account as the Token.
  144300	TTS_CLOUD_INVALID_PARAM	Parameter error.	Check whether the correct parameters were passed.
  144301	TTS_CLOUD_UNSENDAUDIO	The client did not send a command for 10 seconds.	Check for network issues, or check whether there are situations in your business where no data is sent.
  144302	TTS_CLOUD_SENDAUDIO_TOO_FAST	The client is sending data too fast, and server resources are exhausted.	Check whether the client is sending packets too fast and whether they are sent at a 1:1 real-time rate.
  144303	TTS_CLOUD_INVALID_AUDIO_FORMAT	The audio format sent by the client is incorrect.	Convert the audio data format to a format currently supported by the SDK.
  144304	TTS_CLOUD_INVALID_INVOKE	The client method call is abnormal.	The client should call the send request operation first, and then call other operations after the request is sent.
  144305	TTS_CLOUD_INVALID_MAX_SILENCE	The client's MAXSILENCE_PARAM method setting is abnormal.	The range of the MAXSILENCE_PARAM parameter is 200 to 2000.
  144306	TTS_CLOUD_MISMATCHED_SAMPLERATE	The sample rate does not match.	Check whether the sample rate set during the call is consistent with the sample rate of the ASR model bound to the Appkey on the management console.
  144400	TTS_CLOUD_SERVER_ERROR	TTS server error.	This can be ignored if it occurs randomly.
  144401	TTS_CLOUD_INTERNAL_SERVER_ERROR	Server internal error.	Unknown error.
  144402	TTS_CLOUD_SPEECH_TRANSCRIBER_SERVER_ERROR	The real-time speech recognition service is unavailable.	Check whether the real-time speech recognition service has a task backlog that is causing task submission to fail.
  144403	TTS_CLOUD_SPEECH_TRANSCRIBER_REQUEST_TIMEOUT	The request to the real-time speech recognition service timed out.	Check the real-time speech recognition logs.
  144404	TTS_CLOUD_INVOKE_SPEECH_TRANSCRIBER_FAILED	Failed to call the real-time speech recognition service.	Check whether the real-time speech recognition service is started and whether the port is open normally.
  144405	TTS_CLOUD_SPEECH_TRANSCRIBER_BALANCE_FAILED	Real-time speech recognition service load balancing failed. Failed to get the IP address of the real-time speech recognition service.	Check for exceptions with the real-time speech recognition service machine in the VPC.
  144406	TTS_CLOUD_SERVER_AGAIN	Internal call error.	Internal service error. The client needs to retry.