# Error Feedback Codes

During the use of InspireFace, some error feedback codes may be generated. Here is a table of error feedback codes.

- As of **June 15, 2025**, the error code definitions have been restructured. Some legacy codes from historical versions have been removed, and a more streamlined version has been reorganized and consolidated.

 | Index | Name | Code | Comment | 
 | --- | --- | --- | --- | 
 | 1 | HSUCCEED | 0 | Success | 
 | 2 | HERR_UNKNOWN | 1 | Unknown error (1) | 
 | 3 | HERR_INVALID_PARAM | 2 | Invalid parameter (2) | 
 | 4 | HERR_INVALID_IMAGE_STREAM_HANDLE | 3 | Invalid image stream handle (3) | 
 | 5 | HERR_INVALID_CONTEXT_HANDLE | 4 | Invalid context handle (4) | 
 | 6 | HERR_INVALID_FACE_TOKEN | 5 | Invalid face token (5) | 
 | 7 | HERR_INVALID_FACE_FEATURE | 6 | Invalid face feature (6) | 
 | 8 | HERR_INVALID_FACE_LIST | 7 | Invalid face feature list (7) | 
 | 9 | HERR_INVALID_BUFFER_SIZE | 8 | Invalid copy token (8) | 
 | 10 | HERR_INVALID_IMAGE_STREAM_PARAM | 9 | Invalid image param (9) | 
 | 11 | HERR_INVALID_SERIALIZATION_FAILED | 10 | Invalid face serialization failed (10) | 
 | 12 | HERR_INVALID_DETECTION_INPUT | 11 | Failed to modify detector input size (11) | 
 | 13 | HERR_INVALID_IMAGE_BITMAP_HANDLE | 12 | Invalid image bitmap handle (12) | 
 | 14 | HERR_IMAGE_STREAM_DECODE_FAILED | 13 | ImageStream failed to decode the image (13) | 
 | 15 | HERR_SESS_FUNCTION_UNUSABLE | 101 | Function not usable (101) | 
 | 16 | HERR_SESS_TRACKER_FAILURE | 102 | Tracker module not initialized (102) | 
 | 17 | HERR_SESS_PIPELINE_FAILURE | 103 | Pipeline module not initialized (103) | 
 | 18 | HERR_SESS_INVALID_RESOURCE | 104 | Invalid static resource (104) | 
 | 19 | HERR_SESS_LANDMARK_NUM_NOT_MATCH | 105 | The number of input landmark points does not match (105) | 
 | 20 | HERR_SESS_LANDMARK_NOT_ENABLE | 106 | The landmark model is not enabled (106) | 
 | 21 | HERR_SESS_KEY_POINT_NUM_NOT_MATCH | 107 | The number of input key points does not match (107) | 
 | 22 | HERR_SESS_REC_EXTRACT_FAILURE | 108 | Face feature extraction not registered (108) | 
 | 23 | HERR_SESS_REC_CONTRAST_FEAT_ERR | 109 | Incorrect length of feature vector for comparison (109) | 
 | 24 | HERR_SESS_FACE_DATA_ERROR | 110 | Face data parsing (110) | 
 | 25 | HERR_SESS_FACE_REC_OPTION_ERROR | 111 | An optional parameter is incorrect (111) | 
 | 26 | HERR_FT_HUB_DISABLE | 201 | FeatureHub is disabled (201) | 
 | 27 | HERR_FT_HUB_INSERT_FAILURE | 202 | Data insertion error (202) | 
 | 28 | HERR_FT_HUB_NOT_FOUND_FEATURE | 203 | Get face feature error (203) | 
 | 29 | HERR_ARCHIVE_LOAD_FAILURE | 251 | Archive load failure (251) | 
 | 30 | HERR_ARCHIVE_LOAD_MODEL_FAILURE | 252 | Model load failure (252) | 
 | 31 | HERR_ARCHIVE_FILE_FORMAT_ERROR | 253 | The archive format is incorrect (253) | 
 | 32 | HERR_ARCHIVE_REPETITION_LOAD | 254 | Do not reload the model (254) | 
 | 33 | HERR_ARCHIVE_NOT_LOAD | 255 | Model not loaded (255) | 
 | 34 | HERR_DEVICE_CUDA_NOT_SUPPORT | 301 | CUDA not supported (301) | 
 | 35 | HERR_DEVICE_CUDA_TENSORRT_NOT_SUPPORT | 302 | CUDA TensorRT not supported (302) | 
 | 36 | HERR_DEVICE_CUDA_UNKNOWN_ERROR | 303 | CUDA unknown error (303) | 
 | 37 | HERR_DEVICE_CUDA_DISABLE | 304 | CUDA support is disabled (304) | 
 | 38 | HERR_EXTENSION_ERROR | 351 | Extension module error (351) | 
 | 39 | HERR_EXTENSION_MLMODEL_LOAD_FAILED | 352 | MLModel load failed (352) | 
 | 40 | HERR_EXTENSION_HETERO_MODEL_TAG_ERROR | 353 | Incorrect heterogeneous model tag (353) | 
 | 41 | HERR_EXTENSION_HETERO_REC_HEAD_CONFIG_ERROR | 354 | Rec head config error (354) | 
 | 42 | HERR_EXTENSION_HETERO_MODEL_NOT_MATCH | 355 | Heterogeneous model dimensions do not match (355) | 
 | 43 | HERR_EXTENSION_HETERO_MODEL_NOT_LOADED | 356 | Heterogeneous model dimensions not loaded (356) |