當API請求發生錯誤時,服務端會返回錯誤信息。本文為您介紹人臉人體API返回的錯誤碼信息。
阿里云視覺智能開放平臺各類目視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
問題診斷中心
使用問題診斷中心可幫助開發者更高效地診斷API使用過程中的問題。
人臉人體錯誤碼
狀態碼 | 錯誤碼 | 描述 |
403 | AuthFailed | 授權失敗,請檢查RAM權限配置. |
400 | ParameterError | 參數錯誤,請檢查參數值。 |
400 | ClientError.IllegalArgument | 請檢查參數,如參數值所代表的數據庫是否存在。 |
400 | EntityNotExist.Role | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,具體操作,請參見使用RAM Policy控制訪問權限。 |
400 | IllegalUrlParameter | URL不合法,請檢查URL能否正常打開,非上海OSS圖片鏈接,請參見文件URL處理。 |
500 | InternalError | 服務器內部錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
500 | InternalError.Algo | 內部算法處理錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
500 | InternalError.Timeout | 內部處理超時錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
400 | InvalidAccessKeyId.Inactive | AccessKeyID非法,請檢查AccessKeyID是否被禁用,或者AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidDB.Status | 數據庫狀態無效,已被凍結,如需解凍,請通過釘釘群(23109592)聯系我們。 |
404 | InvalidAccessKeyId.NotFound | AccessKeyID不存在。請檢查調用時是否使用了正確的AccessKey。更多信息,請參見創建AccessKey。 |
400 | InvalidAccessKeySecret | AccessKeyID或AccessKeySecret填寫錯誤,請檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidAction.NotFound | 能力未找到,請檢查類目與能力是否匹配,檢查訪問域名與能力是否匹配。更多信息,請參見訪問域名。 選擇合適編程語言根據實例代碼作相關修改進行接入,具體操作,請參見SDK總覽。 |
400 | InvalidApi.ForbiddenInvoke | 調用受限,請檢查您調用的能力是否為受限能力,受限能力需要在控制臺找到相應能力申請,經過審批或者手動激活之后才能調用。 如非上述情況,請檢查賬號是否欠費。 |
403 | InvalidApi.NotPurchase | 產品未開通,請開通產品。 |
400 | InvalidApi.OutOfService | 產品未開通,請開通產品。 |
400 | InvalidFile.Content | 請參考算法文檔檢查文件內容,更換包含符合算法要求的文件。 |
400 | InvalidFile.Decode | 請檢查文件是否能夠正常打開。 |
400 | InvalidFile.Download | 文件無法下載,請檢查本地網絡情況,以及鏈接是否可訪問。非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidFile.REGION | 文件鏈接地域錯誤,非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidFile.Resolution | 文件分辨率超出限制,請檢查文件分辨率和內容,修改文件分辨率后重試。 |
400 | InvalidFile.Type | 文件類型錯誤,請檢查文件類型,參考算法API文檔,使用算法支持的文件類型。阿里云視覺智能開放平臺能夠讀取文件并獲取真實的文件類型,不是通過文件后綴名進行類型判斷,只看文件后綴名是無效的,關于更多文件類型判斷和處理信息,請參見文件類型判斷和處理。 |
400 | InvalidFile.URL | 文件無法下載,請檢查本地網絡情況,以及鏈接是否可訪問。非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidImage.Category | 輸入圖像與當前服務不符,例如,行駛證服務輸入的圖像不是行駛證。 |
400 | InvalidImage.Content | 輸入圖像內容不合法。 例如: 無效的base64編碼圖像;輸入的image是空字符串;無效的image content;圖像解碼失敗;輸入的image不是合法的base64字符串;請刪除base64字符串多余的頭:data:image/jpg:base64;base64編碼的數據長度必須是4的倍數,如果長度不夠,需要在末尾加上 |
400 | InvalidImage.Decode | 請檢查圖片是否能夠正常打開。 |
400 | InvalidImage.Download | 圖片無法下載,請檢查本地網絡情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS圖片鏈接,請參見文件URL處理。URL中不支持空格和中文字符,如包含請通過URLEncode編碼之后再傳入。 |
400 | InvalidImage.Gif | GIF圖像打開失敗、讀取失敗、解碼失敗、獲取顏色映射表錯誤或圖像為空。 |
404 | InvalidImage.NotFoundFace | 圖像中未找到人臉,請檢查您的圖像中是否包含人臉或人臉太小,如果有人臉,請通過釘釘群(23109592)聯系我們。 |
400 | InvalidImage.Region | 圖片所在地域錯誤。 |
400 | InvalidImage.Resolution | 文件分辨率超出限制,請檢查文件分辨率和內容,修改文件分辨率后重試。 |
400 | InvalidImage.Timeout | 圖片下載超時,請檢查本地網絡情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidImage.Type | 圖片類型錯誤,請檢查圖片類型 ,參考算法API文檔,使用算法支持的圖片類型。 |
400 | InvalidImage.Unsafe | URL不安全。 |
415 | InvalidImage.UnsupportedMediaType | 輸入的image解碼失敗。 |
400 | InvalidImage.URL | 圖片鏈接非法,請檢查圖片鏈接是否可訪問,非上海OSS圖片鏈接,請參見文件URL處理。對于上海OSS鏈接請使用標準的OSS域名,目前暫不支持綁定CDN域名和自定義域名。 |
400 | InvalidImageType | 無效的圖片類型。 |
400 | InvalidOutputFormat | 無效的輸出格式。 |
400 | InvalidParameter | 參數值校驗不通過。請使用請求參數構造規范化的請求字符串。詳細信息請參見請求簽名。 |
400 | InvalidParameter.BadRequest | 參數錯誤,請根據算法API文檔和報錯Message檢查參數值。是否參數值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.NotFound | 參數錯誤,請根據算法API文檔和報錯Message檢查參數值。是否參數值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.TooLarge | 待檢測內容過大,請確保待檢測內容在API的限制范圍內。 |
400 | InvalidRamRole | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,操作流程,請參見使用RAM Policy控制訪問權限。 |
400 | InvalidResult | OCR識別失敗、OCR識別異常。 |
400 | InvalidSide | 參數Side無效。 |
400 | InvalidTimeStamp.Expired | 用戶時間和服務器時間相差超過15分鐘,請檢查您的時間戳設置,確保用戶時間和服務器時間的差值在15分鐘內。 |
400 | MissingAccessKeyId | 缺少AccessKeyID信息。具體信息,請參見創建AccessKey。 |
400 | MissingAssureDirection | 缺少AssureDirection參數信息。 |
400 | MissingImageURL | 缺少圖像URL參數。 |
400 | MissingMinHeight | 缺少MinHeight參數。 |
400 | MissingOutputFormat | 缺少輸出格式。 |
400 | MissingParameter | 參數缺失,請參考文檔檢查參數值。 |
400 | QuotaExceeded.ImageCount | 人臉、Trace數量超出限制,請根據文檔中的限制檢查,如需調整限制,請通過釘釘群(23109592)聯系我們。 |
400 | QuotaExceeded.FaceImageCount | 人臉、Trace數量超出限制。請根據文檔中的限制檢查,如需調整限制,請通過釘釘群(23109592)聯系我們。 |
400 | QuotaExceeded.FaceGroupCount | 數據庫數量超出限制。請根據文檔中的限制檢查,如需調整限制,請通過釘釘群(23109592)聯系我們。 |
400 | QuotaExceeded.DbCount | 數據庫數量超出限制。請根據文檔中的限制檢查,如需調整限制,請通過釘釘群(23109592)聯系我們。 |
449 | Retry | 由于網絡抖動等偶發原因導致失敗,需要重試。 |
400 | SDK.ServerUnreachable | SDK端錯誤。 |
503 | ServiceUnavailable | 服務不可用,如果服務器已經返回了RequestId,請通過釘釘群(23109592)聯系我們。 |
500 | ServiceUnavailable | 網絡請求錯誤。請優先檢查本地網絡是否存在故障,例如局域網絡等;如果服務器已經返回了RequestId,請通過釘釘群(23109592)聯系我們。 |
500 | InternalError.Mapping | 內部算法處理錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
400 | SignatureDoesNotMatch | 簽名不正確,請重新計算簽名,具體操作,請參見請求簽名。 |
400 | SignatureNonceUsed | 簽名已經被使用過,請重新計算簽名。具體操作,請參見請求簽名。 |
400 | Throttling | 觸發限流,付費API請購買更高QPS,免費API如有特殊需求,請通過釘釘群(23109592)聯系我們。 說明 觸發限流時Throttling和Throttling.User都有可能出現,處理時都需要考慮。 |
400 | Throttling.User | 該時段的流量已經超限。付費API請購買更高QPS,免費API如有特殊需求,請通過釘釘群(23109592)聯系我們。 說明 觸發限流時Throttling和Throttling.User都有可能出現,處理時都需要考慮。 |
408 | Timeout | 請求或處理超時失敗。 |
403 | Unauthorized | RAM權限校驗未通過,更多信息,請參見使用RAM Policy控制訪問權限。 |
403 | UnsupportedHTTPMethod | HTTP請求方法不支持。建議查看各個產品的API調用方式文檔。 |
公共錯誤碼
API的公共錯誤碼請參見API錯誤中心。
處理建議
請求服務出現錯誤碼提示,請參見錯誤碼描述查看具體錯誤原因,并進行錯誤處理。針對一些常見高頻的錯誤類型,此處提供一些錯誤處理建議供您參考。
URL類錯誤碼
此類錯誤碼一般都是文件URL不符合要求,例如URL不安全、無效。更多信息,請參見文件URL處理。
圖像加載錯誤碼
此類錯誤也可以看作是圖像URL錯誤,例如圖像下載錯誤、地域錯誤。當前系統推薦使用華東2(上海)地域,如果您通過OSS生成URL,那么您在OSS上創建的Bucket所屬地域應該為華東2(上海)。更多信息,請參見文件URL處理。
參數類錯誤碼
此類錯誤碼一般是輸入參數不符合要求,例如參數缺失、參數類型錯誤等。建議您檢查輸入參數是否符合要求,您可以參考對應API文檔中的請求參數表格進行檢查確認。
系統服務類錯誤碼
如果出現此類錯誤碼,建議您重新發起服務請求,如果問題依然存在,請在釘釘群組(23109592)中反饋問題。