目標(biāo)檢測(cè)常見錯(cuò)誤碼
當(dāng)API請(qǐng)求發(fā)生錯(cuò)誤時(shí)，服務(wù)端會(huì)返回錯(cuò)誤信息。本文為您介紹目標(biāo)檢測(cè)API返回的錯(cuò)誤碼信息。
阿里云視覺智能開放平臺(tái)各類目視覺AI能力API接入、接口使用或問題咨詢等，請(qǐng)通過釘釘群（23109592）加入阿里云視覺智能開放平臺(tái)咨詢?nèi)郝?lián)系我們。
問題診斷中心
使用問題診斷中心可幫助開發(fā)者更高效地診斷API使用過程中的問題。
目標(biāo)檢測(cè)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 |
403 | AuthFailed | 授權(quán)失敗，請(qǐng)檢查RAM權(quán)限配置。 |
400 | ClientError.IllegalArgument | 請(qǐng)求參數(shù)錯(cuò)誤，詳情查看message信息。 |
409 | Data.Exist | 數(shù)據(jù)已經(jīng)存在。 |
400 | EntityNotExist.Role | 沒有RAM權(quán)限，請(qǐng)聯(lián)系主賬號(hào)給你添加AliyunVIAPIFullAccess權(quán)限，具體操作，請(qǐng)參見使用RAM Policy控制訪問權(quán)限。 |
400 | IllegalUrlParameter | URL不合法，請(qǐng)檢查URL能否正常打開，非上海OSS圖片鏈接，請(qǐng)參見文件URL處理。 |
500 | InternalError | 服務(wù)器內(nèi)部錯(cuò)誤。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Algo | 內(nèi)部算法處理錯(cuò)誤。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Convert | 輸入?yún)?shù)轉(zhuǎn)換失敗。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Decode | 圖像解碼失敗。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Env | 初始化環(huán)境失敗。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Mapping | 內(nèi)部算法處理錯(cuò)誤，如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Model | 模型加載錯(cuò)誤。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Process | 推理過程異常。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Timeout | 算法服務(wù)內(nèi)部處理超時(shí)錯(cuò)誤，請(qǐng)稍后重試。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | InternalError.Transfer | 下載或上傳數(shù)據(jù)失敗。請(qǐng)稍后重試。如有影響業(yè)務(wù)，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
400 | InvalidAccessKeyId.Inactive | AccessKeyID非法，請(qǐng)檢查AccessKeyID是否被禁用，或者AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidAccessKeyId.NotFound | AccessKeyID未找到，請(qǐng)檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidAccessKeySecret | AccessKeyID或AccessKeySecret填寫錯(cuò)誤，請(qǐng)檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidAction.NotFound | 能力未找到，請(qǐng)檢查類目與能力是否匹配，檢查訪問域名與能力是否匹配。更多信息，請(qǐng)參見訪問域名。 選擇合適編程語言根據(jù)實(shí)例代碼作相關(guān)修改進(jìn)行接入，具體操作，請(qǐng)參見SDK總覽。 |
400 | InvalidApi.ForbiddenInvoke | 調(diào)用受限，請(qǐng)檢查您調(diào)用的能力是否為受限能力，受限能力需要在控制臺(tái)找到相應(yīng)能力申請(qǐng)，經(jīng)過審批或者手動(dòng)激活之后才能調(diào)用。 如非上述情況，請(qǐng)檢查賬號(hào)是否欠費(fèi)。 |
400 | InvalidApi.NotPurchase | 服務(wù)未開通，請(qǐng)先開通服務(wù)。 |
400 | InvalidApi.OutOfService | 產(chǎn)品未開通，請(qǐng)開通產(chǎn)品。 |
400 | InvalidFile.Content | 圖片或視頻文件的內(nèi)容格式不正確。 |
400 | InvalidFile.Decode | 文件解碼失敗、 |
400 | InvalidFile.Download | 文件無法下載，請(qǐng)檢查本地網(wǎng)絡(luò)情況，以及鏈接是否可訪問。非上海OSS文件鏈接，請(qǐng)參見文件URL處理。 |
400 | InvalidFile.Region | 文件URL格式不正確，必須是阿里云同Region的OSS文件地址。 |
400 | InvalidFile.Resolution | 圖片或視頻的分辨率錯(cuò)誤。 |
400 | InvalidFile.Type | 文件類型錯(cuò)誤，請(qǐng)檢查文件類型，參考算法API文檔，使用算法支持的文件類型。阿里云視覺智能開放平臺(tái)能夠讀取文件并獲取真實(shí)的文件類型，不是通過文件后綴名進(jìn)行類型判斷，只看文件后綴名是無效的，關(guān)于更多文件類型判斷和處理信息，請(qǐng)參見文件類型判斷和處理。 |
400 | InvalidFile.URL | 文件URL格式不正確，必須是阿里云同Region的OSS文件地址。 |
400 | InvalidImage.Content | 請(qǐng)參考算法文檔檢查圖片內(nèi)容，更換包含符合算法要求的圖片。 |
400 | InvalidImage.Decode | 圖片或視頻文件的內(nèi)容格式不正確。 |
400 | InvalidImage.Download | 圖片無法下載，請(qǐng)檢查本地網(wǎng)絡(luò)情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS圖片鏈接，請(qǐng)參見文件URL處理。URL中不支持空格和中文字符，如包含請(qǐng)通過URLEncode編碼之后再傳入。 |
404 | InvalidImage.NotFound | 參數(shù)中的圖片文件不存在。 |
404 | InvalidImage.NotFoundFace | 輸入的圖片中沒有檢測(cè)到人臉。 |
400 | InvalidImage.Region | 文件URL格式不正確，必須是阿里云同Region的OSS文件地址。 |
400 | InvalidImage.Resolution | 圖片或視頻的分辨率錯(cuò)誤。 |
400 | InvalidImage.Timeout | 下載文件超時(shí)失敗。 |
400 | InvalidImage.Type | 圖片類型錯(cuò)誤，請(qǐng)檢查圖片類型 ，參考算法API文檔，使用算法支持的圖片類型。 |
400 | InvalidImage.URL | 圖片鏈接非法，請(qǐng)檢查圖片鏈接是否可訪問，非上海OSS圖片鏈接，請(qǐng)參見文件URL處理。對(duì)于上海OSS鏈接請(qǐng)使用標(biāo)準(zhǔn)的OSS域名，目前暫不支持綁定CDN域名和自定義域名。 |
400 | InvalidParameter | 請(qǐng)求參數(shù)錯(cuò)誤。 |
400 | InvalidParameter.BadRequest | 請(qǐng)求的參數(shù)/數(shù)據(jù)有錯(cuò)誤。 |
400 | InvalidParameter.NotFound | 請(qǐng)求的數(shù)據(jù)不存在。 |
400 | InvalidParameter.TooLarge | 文件大小超出限制。 |
400 | InvalidParameter.Type | 請(qǐng)求參數(shù)的數(shù)據(jù)格式錯(cuò)誤。 |
400 | InvalidParameter.Unsuitable | 數(shù)據(jù)為空或不適合被處理。 |
400 | InvalidParamter.Type | 請(qǐng)求參數(shù)的數(shù)據(jù)格式錯(cuò)誤。 |
400 | InvalidRamRole | 沒有RAM權(quán)限，請(qǐng)聯(lián)系主賬號(hào)給您添加AliyunVIAPIFullAccess權(quán)限，操作流程，請(qǐng)參見使用RAM Policy控制訪問權(quán)限。 |
400 | InvalidResult | 參數(shù)錯(cuò)誤，請(qǐng)參考文檔檢查參數(shù)值，檢查文件內(nèi)容。請(qǐng)檢查是否圖片內(nèi)容不完整或者太模糊等。 |
400 | InvalidSide | Specified parameter Side is not valid. 請(qǐng)參考文檔填寫正確的Side參數(shù)。 |
400 | InvalidTimeStamp.Expired | 時(shí)間戳過期，請(qǐng)更新時(shí)間戳。 |
400 | MissingAccessKeyId | AccessKeyID未填寫，請(qǐng)檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | MissingParameter | 入?yún)⑷笔А?/p> |
400 | ParameterError | 參數(shù)錯(cuò)誤，請(qǐng)檢查參數(shù)值。 |
400 | QuotaExceeded.DbCount | 數(shù)據(jù)庫數(shù)量超出限制。 |
400 | QuotaExceeded.FaceGroupCount | 數(shù)據(jù)庫數(shù)量超出限制。 |
400 | QuotaExceeded.FaceImageCount | 人臉、Trace數(shù)量超出限制。 |
400 | QuotaExceeded.ImageCount | 人臉、Trace數(shù)量超出限制。 |
449 | Retry | 由于網(wǎng)絡(luò)抖動(dòng)等偶發(fā)原因?qū)е率。枰卦嚒?/p> |
400 | SDK.ServerUnreachable | SDK端錯(cuò)誤。 |
503 | ServiceUnavailable | 服務(wù)不可用，如果服務(wù)器已經(jīng)返回了RequestId，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
500 | ServiceUnavailable | 網(wǎng)絡(luò)請(qǐng)求錯(cuò)誤。請(qǐng)優(yōu)先檢查本地網(wǎng)絡(luò)是否存在故障，例如局域網(wǎng)絡(luò)等；如果服務(wù)器已經(jīng)返回了RequestId，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 |
400 | SignatureDoesNotMatch | 簽名不正確，請(qǐng)重新計(jì)算簽名。具體操作，請(qǐng)參見請(qǐng)求簽名。 |
400 | SignatureNonceUsed | 簽名已經(jīng)被使用過，請(qǐng)重新計(jì)算簽名。具體操作，請(qǐng)參見請(qǐng)求簽名。 |
400 | Throttling | 觸發(fā)限流，付費(fèi)API請(qǐng)購買更高QPS，免費(fèi)API如有特殊需求，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 說明 觸發(fā)限流時(shí)Throttling和Throttling.User都有可能出現(xiàn)，處理時(shí)都需要考慮。 |
400 | Throttling.User | 該時(shí)段的流量已經(jīng)超限。付費(fèi)API請(qǐng)購買更高QPS，免費(fèi)API如有特殊需求，請(qǐng)通過釘釘群（23109592）聯(lián)系我們。 說明 觸發(fā)限流時(shí)Throttling和Throttling.User都有可能出現(xiàn)，處理時(shí)都需要考慮。 |
408 | Timeout | 請(qǐng)求或處理超時(shí)失敗。 |
403 | Unauthorized | RAM權(quán)限校驗(yàn)未通過，具體請(qǐng)參見使用RAM Policy控制訪問權(quán)限。 |
公共錯(cuò)誤碼
API的公共錯(cuò)誤碼請(qǐng)參見API錯(cuò)誤中心。
處理建議
請(qǐng)求服務(wù)出現(xiàn)錯(cuò)誤碼提示，請(qǐng)參見錯(cuò)誤碼描述查看具體錯(cuò)誤原因，并進(jìn)行錯(cuò)誤處理。針對(duì)一些常見高頻的錯(cuò)誤類型，此處提供一些錯(cuò)誤處理建議供您參考。
URL類錯(cuò)誤碼
此類錯(cuò)誤碼一般都是文件URL不符合要求，例如URL不安全、無效。更多信息，請(qǐng)參見文件URL處理。
圖像加載錯(cuò)誤碼
此類錯(cuò)誤也可以看作是圖像URL錯(cuò)誤，例如圖像下載錯(cuò)誤、地域錯(cuò)誤。當(dāng)前系統(tǒng)推薦使用華東2（上海）地域，如果您通過OSS生成URL，那么您在OSS上創(chuàng)建的Bucket所屬地域應(yīng)該為華東2（上海）。更多信息，請(qǐng)參見文件URL處理。
參數(shù)類錯(cuò)誤碼
此類錯(cuò)誤碼一般是輸入?yún)?shù)不符合要求，例如參數(shù)缺失、參數(shù)類型錯(cuò)誤等。建議您檢查輸入?yún)?shù)是否符合要求，您可以參考對(duì)應(yīng)API文檔中的請(qǐng)求參數(shù)表格進(jìn)行檢查確認(rèn)。
系統(tǒng)服務(wù)類錯(cuò)誤碼
如果出現(xiàn)此類錯(cuò)誤碼，建議您重新發(fā)起服務(wù)請(qǐng)求，如果問題依然存在，請(qǐng)?jiān)卺斸斎航M（23109592）中反饋問題。