Back to Insightface

Error Feedback Codes

cpp-package/inspireface/doc/Error-Feedback-Codes.md

0.73.7 KB
Original Source

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.
IndexNameCodeComment
1HSUCCEED0Success
2HERR_UNKNOWN1Unknown error (1)
3HERR_INVALID_PARAM2Invalid parameter (2)
4HERR_INVALID_IMAGE_STREAM_HANDLE3Invalid image stream handle (3)
5HERR_INVALID_CONTEXT_HANDLE4Invalid context handle (4)
6HERR_INVALID_FACE_TOKEN5Invalid face token (5)
7HERR_INVALID_FACE_FEATURE6Invalid face feature (6)
8HERR_INVALID_FACE_LIST7Invalid face feature list (7)
9HERR_INVALID_BUFFER_SIZE8Invalid copy token (8)
10HERR_INVALID_IMAGE_STREAM_PARAM9Invalid image param (9)
11HERR_INVALID_SERIALIZATION_FAILED10Invalid face serialization failed (10)
12HERR_INVALID_DETECTION_INPUT11Failed to modify detector input size (11)
13HERR_INVALID_IMAGE_BITMAP_HANDLE12Invalid image bitmap handle (12)
14HERR_IMAGE_STREAM_DECODE_FAILED13ImageStream failed to decode the image (13)
15HERR_SESS_FUNCTION_UNUSABLE101Function not usable (101)
16HERR_SESS_TRACKER_FAILURE102Tracker module not initialized (102)
17HERR_SESS_PIPELINE_FAILURE103Pipeline module not initialized (103)
18HERR_SESS_INVALID_RESOURCE104Invalid static resource (104)
19HERR_SESS_LANDMARK_NUM_NOT_MATCH105The number of input landmark points does not match (105)
20HERR_SESS_LANDMARK_NOT_ENABLE106The landmark model is not enabled (106)
21HERR_SESS_KEY_POINT_NUM_NOT_MATCH107The number of input key points does not match (107)
22HERR_SESS_REC_EXTRACT_FAILURE108Face feature extraction not registered (108)
23HERR_SESS_REC_CONTRAST_FEAT_ERR109Incorrect length of feature vector for comparison (109)
24HERR_SESS_FACE_DATA_ERROR110Face data parsing (110)
25HERR_SESS_FACE_REC_OPTION_ERROR111An optional parameter is incorrect (111)
26HERR_FT_HUB_DISABLE201FeatureHub is disabled (201)
27HERR_FT_HUB_INSERT_FAILURE202Data insertion error (202)
28HERR_FT_HUB_NOT_FOUND_FEATURE203Get face feature error (203)
29HERR_ARCHIVE_LOAD_FAILURE251Archive load failure (251)
30HERR_ARCHIVE_LOAD_MODEL_FAILURE252Model load failure (252)
31HERR_ARCHIVE_FILE_FORMAT_ERROR253The archive format is incorrect (253)
32HERR_ARCHIVE_REPETITION_LOAD254Do not reload the model (254)
33HERR_ARCHIVE_NOT_LOAD255Model not loaded (255)
34HERR_DEVICE_CUDA_NOT_SUPPORT301CUDA not supported (301)
35HERR_DEVICE_CUDA_TENSORRT_NOT_SUPPORT302CUDA TensorRT not supported (302)
36HERR_DEVICE_CUDA_UNKNOWN_ERROR303CUDA unknown error (303)
37HERR_DEVICE_CUDA_DISABLE304CUDA support is disabled (304)
38HERR_EXTENSION_ERROR351Extension module error (351)
39HERR_EXTENSION_MLMODEL_LOAD_FAILED352MLModel load failed (352)
40HERR_EXTENSION_HETERO_MODEL_TAG_ERROR353Incorrect heterogeneous model tag (353)
41HERR_EXTENSION_HETERO_REC_HEAD_CONFIG_ERROR354Rec head config error (354)
42HERR_EXTENSION_HETERO_MODEL_NOT_MATCH355Heterogeneous model dimensions do not match (355)
43HERR_EXTENSION_HETERO_MODEL_NOT_LOADED356Heterogeneous model dimensions not loaded (356)