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