Troubleshooting

A reference of standardized error codes returned by the Nexa SDK interface.

The Nexa SDK uses structured error codes to help users diagnose and resolve issues encountered during model inference or system operation.
Use this document to quickly look up the meaning of any returned error code.

Common Errors (100xxx)

General-purpose errors related to invalid input, memory allocation, or unsupported operations.

Error Code	Name	Description
-100000	ML_ERROR_COMMON_UNKNOWN	Unknown error
-100001	ML_ERROR_COMMON_INVALID_INPUT	Invalid input parameters or handle
-100003	ML_ERROR_COMMON_MEMORY_ALLOCATION	Memory allocation failed
-100004	ML_ERROR_COMMON_FILE_NOT_FOUND	File not found or inaccessible
-100007	ML_ERROR_COMMON_NOT_INITIALIZED	Library not initialized
-100013	ML_ERROR_COMMON_NOT_SUPPORTED	Operation not supported
-100201	ML_ERROR_COMMON_MODEL_LOAD	Model loading failed
-100203	ML_ERROR_COMMON_MODEL_INVALID	Invalid model format
-100301	ML_ERROR_COMMON_EMBEDDING_GENERATION	Embedding generation failed
-100302	ML_ERROR_COMMON_EMBEDDING_DIMENSION	Invalid embedding dimension
-100401	ML_ERROR_COMMON_RERANK_FAILED	Reranking failed
-100402	ML_ERROR_COMMON_RERANK_INPUT	Invalid reranking input
-100501	ML_ERROR_COMMON_IMG_GENERATION	Image generation failed
-100502	ML_ERROR_COMMON_IMG_PROMPT	Invalid image prompt
-100503	ML_ERROR_COMMON_IMG_DIMENSION	Invalid image dimensions

LLM Errors (200xxx)

Errors encountered during language model tokenization or text generation.

Error Code	Name	Description
-200001	ML_ERROR_LLM_TOKENIZATION_FAILED	Tokenization failed
-200004	ML_ERROR_LLM_TOKENIZATION_CONTEXT_LENGTH	Context length exceeded
-200101	ML_ERROR_LLM_GENERATION_FAILED	Text generation failed
-200103	ML_ERROR_LLM_GENERATION_PROMPT_TOO_LONG	Input prompt too long

VLM Errors (300xxx)

Errors related to processing images and audio in vision-language models.

Error Code	Name	Description
-300001	ML_ERROR_VLM_IMAGE_LOAD	Image loading failed
-300002	ML_ERROR_VLM_IMAGE_FORMAT	Unsupported image format
-300101	ML_ERROR_VLM_AUDIO_LOAD	Audio loading failed
-300102	ML_ERROR_VLM_AUDIO_FORMAT	Unsupported audio format
-300201	ML_ERROR_VLM_GENERATION_FAILED	Multimodal generation failed

OCR Errors (400xxx)

Issues specific to text detection and recognition from images.

Error Code	Name	Description
-400001	ML_ERROR_OCR_DETECTION	OCR text detection failed
-400002	ML_ERROR_OCR_RECOGNITION	OCR text recognition failed
-400003	ML_ERROR_OCR_MODEL	OCR model error

ASR Errors (500xxx)

Errors encountered while transcribing audio using automatic speech recognition.

Error Code	Name	Description
-500001	ML_ERROR_ASR_TRANSCRIPTION	ASR transcription failed
-500002	ML_ERROR_ASR_AUDIO_FORMAT	Unsupported ASR audio format
-500003	ML_ERROR_ASR_LANGUAGE	Unsupported ASR language

TTS Errors (600xxx)

Issues related to speech synthesis, voice selection, or audio format output.

Error Code	Name	Description
-600001	ML_ERROR_TTS_SYNTHESIS	TTS synthesis failed
-600002	ML_ERROR_TTS_VOICE	TTS voice not found
-600003	ML_ERROR_TTS_AUDIO_FORMAT	TTS audio format error

Was this page helpful?

Yes

No