HomeDocsConsolePricing

API Error Codes

HTTP Status Codes

Status CodeError MessageDescription
200Successful RequestSuccessful request
400Bad RequestInvalid request, typically caused by issues such as an image not meeting the required specifications. For details, see Algorithm Error Codes
401Authentication FailedAuthentication failed. If this error occurs, verify that your AK/SK credentials are correct
403Authentication FailedAuthentication failed. If this error occurs, verify whether your application has expired
404Invalid API EndpointThe requested API endpoint address is incorrect. Verify that the request endpoint address is correct
415Internal Algorithm ExceptionAn internal algorithm exception occurred. Please try again later
424Image Download FailedFailed to download the image. Verify that the image URL you are using can be accessed and downloaded normally
429QPS Limit ExceededVerify whether the current QPS is abnormal. If you require a higher QPS limit, please contact Sales to purchase additional capacity
433Request Entity Too LargeThe request entity is too large. Check whether your image exceeds the API limit
500Request ExceptionAn internal request exception occurred. Please try again later
502No ResponseNo response was received for the request. Please try again later
503Concurrency Too HighRequest concurrency exceeds the limit
504Request ExceptionAn internal request exception occurred. Please try again later
599Request TimeoutThe request timed out. Please try again later

Gateway

Gateway-related error codes, typically authentication errors.

ErrorCodeError MessageDescription
80001RIGHTS_LIMIT_EXCEEDEDEntitlement usage limit exceeded
80002ORDER_LIMIT_EXCEEDEDOrder usage count limit exceeded
80999RIGHTS_UNKNOW_ERRORerr information: unknown entitlement-related error
90000GATEWAY_INVALID_PARAMETERInvalid input parameter; parameter binding failed
90001GATEWAY_PARAMETER_ERRORInvalid input parameter value; error caused by operations on the input parameter
90002GATEWAY_AUTHORIZED_ERRORAuthentication error
90003GATEWAY_AUTHORIZED_NOT_MATCHAuthentication mismatch
90004GATEWAY_INVALID_FORMFILEInvalid form file; form file extraction failed
90005GATEWAY_AUTHORIZED_NOT_ACCEPTABLEAuthentication unavailable
90006GATEWAY_FORMAT_HEADERS_ERRORException while formatting headers
90007GATEWAY_FORMAT_BODY_ERRORException while formatting the body
90008GATEWAY_FORMAT_PARAMS_ERRORException while formatting parameters
90009GATEWAY_TIMEOUTRequest timeout
90010GATEWAY_JSON_MARSHAL_ERRORJSON encoding error
90011GATEWAY_JSON_UNMARSHAL_ERRORJSON decoding error
90012GATEWAY_BASE64_ENCODE_ERRORBase64 encoding error
90013GATEWAY_BASE64_DECODE_ERRORBase64 decoding error
90014GATEWAY_NOT_FOUNDData not found
90015GATEWAY_FOUND_ERRORData query exception
90016GATEWAY_PUSH_QUEUE_ERRORQueue push exception
90017GATEWAY_GET_BODY_ERRORException while reading the body
90020GATEWAY_REQUEST_FORWARD_ERRORException while processing the algorithm request
90021GATEWAY_FORWARD_RESPONSE_ERRORException while processing the algorithm response
90022GATEWAY_ALGORITHM_DISABLEAlgorithm unavailable
90023GATEWAY_QUEUE_RESPONSE_ERRORAlgorithm queue response exception
90024GATEWAY_QPS_LIMITCurrent QPS limit exceeded
90099GATEWAY_UNKNOWN_ERRORUnknown error

Common Algorithm Error Codes

ErrorCodeError MessageDescription
10000INVALID_PARAMETERInvalid parameter
10002REQUEST_TIMEOUTRequest timeout
10003IMAGE_DOWNLOAD_FAILEDImage download failed
10004TASK_NOEXISTTask does not exist
10005SO_ERRORSO library error
10006CONTENT_ERRORContent error
10007DECODE_IMAGE_ERRORImage decoding error
10008ENCODE_IMAGE_ERRORImage encoding error
10009PROCESS_IMAGE_ERRORImage processing error
10010LENTP_ERRORLentp image parsing error
10011SHARE_ERRORShared memory error
10012IMAGE_LENGTH_ERRORImage length reception error
10013BASE64_DECODE_ERRORBase64 decoding error
10014URLDECODE_ERRORUrlDecode decoding error
10015RESOURCE_ERRORInsufficient GPU/video memory resources; service temporarily unavailable
10016SLICE_IMAGE_ERRORImage slicing error
10017MERGE_IMAGE_ERRORImage block merging error
10018FPGA_PROCESS_ERRORFPGA processing error
10019FPGA_PROCESS_TIMEOUTFPGA processing timeout
10024UNKNOWN_ERRORUnknown error
10025INVALID_RESOURCESInvalid resource: input
10026INVALID_RESOURCESInvalid resource: output
10027INVALID_RESOURCESInvalid resource: text
11002HANDLE_ERRORWorkflow processing exception. For the specific cause, refer to the error code returned in the message field

Algorithm-Specific Error Code Summary

ErrorCode Status CodeError MessageDescription
20001PROCESS_ERRORProcessing error
20003DETECT_NOT_FACEFace missing
20004MORE_THAN_ONE_FACEMore than one face detected
20007MISSING_LANDMARK_ARGUMENTSFace landmark points were not provided
20008UNSUITABLE_IMAGEThe image does not meet the required specifications
20009UNSUPPORT_TYPEUnsupported type
20010DETECT_NOT_FACENo face detected in the second image
20011UNSUITABLE_VERTICAL_IMAGEVertical height does not meet the requirements
20012UNSUITABLE_HORIZONTAL_IMAGEHorizontal width does not meet the requirements
20013RESOLUTION_TOO_LARGE_ERRORResolution is too large
20014NOT_FOUNDImage not found
20015PICTURE_OVERRUN_ERRORImage exceeds the limit
20020DETECT_FACE_OUTOFIMAGEFacial features are missing
20021DETECT_FACE_PITCHANGLE_BIGThe face is not frontal; nodding/pitch angle is too large
20022DETECT_FACE_YAWANGLE_BIGThe face is not frontal; head rotation/yaw angle is too large
20023DETECT_FACE_LOWAREAFace occupies too little of the image / pixel count is too low
20024MASK_NOT_ENOUGHInsufficient number of people detected
20025INIT_FAILInitialization failed
20026NO_SUCH_MODENo such mode
20027TOO_SMALL_AREAAvailable area for image placement is too small
20028NO_MATERIALS_TO_PASTENo materials are available for placement
20029TOO_SMALL_SIZEMaterial dimensions are too small
20030WRONG_DIRECTDirection parameter error
20031TOO_BIG_DENSITYDensity is too high
20032NO_CATS_OR_DOGSNo cats or dogs detected
20033SKY_THRESHOLD_TOO_LOWNo sky region detected
21001LOAD_MODEL_ERRORFailed to load the model
21002HAIR_MASK_LOSSHair mask missing
21003FACE_NUM_ERRORIncorrect number of faces
21004AR_PARSE_FAULTError parsing the plist in AR
21005AR_EEEOR_COUNTAR face error
21006AR_FACE_OUTAR exceeds the face range
21007JSON_ERRORJSON content error
21008BACKGROUND_IMAGE_LOSSBackground image missing
21009BODY_MASK_LOSSBody mask missing
21010FACE_ANGLE_ERRORFace angle error
21011SKIN_MASK_LOSSSkin mask missing
21012BODY_INFO_LOSSSkeletal keypoints or outer contour points are missing
21013RECT_OUT_IMAGEExceeds the image bounds
21014DETECT_NO_BODYBody mask is empty
21015AGE_INFO_LOSSAge data missing
21016GENDER_INFO_LOSSGender data missing
21017CSKETCH_TYPE_ERRORSketch type error
21018CSKETCH_STRING_ERRORInvalid externally supplied string for the sketch
21019CSKETCH_INVALID_NICKNAMEIndicates that the user's nickname contains invalid characters
21020CSKETCH_NULL_INPUT_STRINGIndicates that the user's nickname contains invalid characters

Asynchronous Algorithm-Specific Error Code Summary

ErrorCode Status CodeError MessageDescription
0SUCCESSSuccess
29900RECORD_NOT_FOUNDSpecified record not found
29901NOT_RESULTThe algorithm is processing. Please try again later
29902TIMEOUT_EXCEPTIONTimeout exception handling
29903PROCESS_IMAGE_ERRORImage processing or upload failed
29904ALGORITHM_OVER_CONCURRENTAlgorithm concurrency limit exceeded
29905ALGORITHM_INNER_ERRORInternal algorithm error
29915RESPONSE_EMPTYAlgorithm processing failed
29950UNKNOW_ERRORUnknown error

Audio/Video Decoding Error Code Summary

ErrorCodeError MessageDescription
23101IMAGE_DECODE_ERRORImage decoding error
23102IMAGE_DECODE_FORMAT_ERRORImage format error
23103IMAGE_DECODE_SIZE_ERRORImage size error
23104IMAGE_DECODE_CHANNEL_ERRORImage channel error
23201VIDEO_DECODE_DECODE_ERRORVideo decoding error
23202VIDEO_DECODE_FORMAT_ERRORVideo format error
23203VIDEO_DECODE_SIZE_ERRORVideo size error
23204VIDEO_DECODE_CHANNEL_ERRORVideo channel error
23205-Video decoder creation error
23206-Video surface converter creation error
23207-Video frame-to-surface conversion error
23301AUDIO_DECODE_ERRORAudio decoding error
23302AUDIO_DECODE_FORMAT_ERRORAudio format error
23303AUDIO_DECODE_SIZE_ERRORAudio size error
23304AUDIO_DECODE_CHANNEL_ERRORAudio channel error

Audio/Video Encoding Error Code Summary

ErrorCodeError MessageDescription
24101IMAGE_ENCODE_ERRORImage encoding error
24102IMAGE_ENCODE_FORMAT_ERRORImage format error
24103IMAGE_ENCODE_SIZE_ERRORImage size error
24104IMAGE_ENCODE_CHANNEL_ERRORImage channel error
24201VIDEO_ENCODE_ERRORVideo encoding error
24202VIDEO_ENCODE_FORMAT_ERRORVideo format error
24203VIDEO_ENCODE_SIZE_ERRORVideo size error
24204VIDEO_ENCODE_CHANNEL_ERRORVideo channel error
24205-Video encoder creation error
24206-Video encoding frame release error
24207-Video encoding frame allocation error
24208-Surface-to-video-frame conversion error
24301AUDIO_ENCODE_ERRORAudio encoding error
24302AUDIO_ENCODE_FORMAT_ERRORAudio format error
24303AUDIO_ENCODE_SIZE_ERRORAudio size error
24304AUDIO_ENCODE_CHANNEL_ERRORAudio channel error

External-Cause Error Code Summary

ErrorCodeError MessageDescription
21101PARAM_ERRORParameter error
21102PARAM_MISSING_ERRORMissing parameter
21103PARAM_TYPE_ERRORParameter type error
21104PARAM_VALUE_ERRORParameter value error
21105PARAM_JSON_DECODE_ERRORParameter value error
21201DOWNLOAD_TIMEOUT_ERRORFile download timeout
21202INVALID_URL_ERRORInvalid URL
21203FILE_NOT_EXIST_ERRORInvalid file
21204NETWORK_ERRORNetwork error
21205DOWNLOAD_UNKNOWN_ERRORDownload error
22101SAVE_ERRORSave error
22102SAVE_PATH_ERRORSave path error
22103SAVE_FORMAT_ERRORSave format error
22201UPLOAD_ERRORUpload error
22202UPLOAD_PATH_ERRORUpload path error
22203UPLOAD_FILE_TOO_LARGE_ERRORUploaded file is too large
22204UPLOAD_TIMEOUT_ERRORFile upload timeout
22301DELETE_FILE_ERRORDelete error