當API請求發生錯誤的時候,服務端會返回錯誤信息。本文為您介紹內容審核API返回的錯誤碼信息。
阿里云視覺智能開放平臺各類目視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
問題診斷中心
使用問題診斷中心可幫助開發者更高效地診斷API使用過程中的問題。
內容安全錯誤碼
HTTP 狀態碼 | 錯誤代碼 | 描述 |
403 | AuthFailed | 授權失敗,請檢查RAM權限配置。 |
400 | ClientError.IllegalArgument | 請檢查參數,如參數值所代表的數據庫是否存在。 |
403 | EntityNotExist.Role | 沒有RAM權限,請聯系主賬號給你添加AliyunVIAPIFullAccess權限,具體操作,請參見使用RAM Policy控制訪問權限。 |
400 | IllegalUrlParameter | URL不合法,請檢查URL能否正常打開,非上海OSS圖片鏈接,請參見文件URL處理。 |
500 | InternalError | 服務器內部錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
586 | InternalError.Algo | 內部算法處理錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
585 | InternalError.Cache | 緩存出錯。建議重試,若持續返回該錯誤碼,請通過釘釘群(23109592)聯系我們。 |
591 | InternalError.ConnectPool | 連接池滿。請通過釘釘群(23109592)聯系我們。 |
580 | InternalError.DB | 數據庫操作失敗。建議重試,若持續返回該錯誤碼,請通過釘釘群(23109592)聯系我們。 |
595 | InternalError.Frame | 截幀失敗,請通過釘釘群(23109592)聯系我們。 |
587 | InternalError.MiddleWare | 中間件出錯。請通過釘釘群(23109592)聯系我們。 |
581 | InternalError.Timeout | 算法內部處理超時錯誤。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
400 | InvalidAccessKeyId.Inactive | AccessKeyID非法,請檢查AccessKeyID是否被禁用,或者AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | InvalidAccessKeyId.NotFound | AccessKeyID未找到,請檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
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.Content | 請參考算法文檔檢查圖片內容,更換包含符合算法要求的圖片。 |
400 | InvalidImage.Decode | 請檢查圖片是否能夠正常打開。 |
400 | InvalidImage.Download | 圖片無法下載,請檢查本地網絡情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS圖片鏈接,請參見文件URL處理。URL中不支持空格和中文字符,如包含請通過URLEncode編碼之后再傳入。 |
404 | InvalidImage.NotFound | 待檢測內容未找到,通常是由于您的圖片/視頻/語音內容無法下載導致,請確認內容可通過公網訪問到。 |
404 | InvalidImage.NotFoundFace | 圖像中沒找到人臉,請檢查您的圖像中是否包含人臉或人臉太小 |
400 | InvalidImage.REGION | 圖片鏈接地域錯誤,非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidImage.Resolution | 文件分辨率超出限制,請檢查文件分辨率和內容,修改文件分辨率后重試。 |
480 | InvalidImage.Restriction | 下載失敗,請確認待檢測內容的大小或分辨率在API的限制范圍內。 |
400 | InvalidImage.Timeout | 下載超時,下載時間限制為3秒,請確保待檢測的內容大小在API的限制范圍內。 |
400 | InvalidImage.Type | 圖片類型錯誤,請檢查圖片類型,參考算法API文檔,使用算法支持的圖片類型。 |
403 | InvalidImage.Unaccessable | 請求訪問失敗,通常是由于您的圖片/視頻/語音鏈接無法訪問導致,請確認公網是否可以訪問,并且無防盜鏈策略。 |
401 | InvalidImage.Unsafe | 請求失敗,通常是由于使用了不安全的圖片/視頻/語音鏈接地址。 |
400 | InvalidImage.URL | 圖片鏈接非法,請檢查圖片鏈接是否可訪問,非上海OSS圖片鏈接,請參見文件URL處理。對于上海OSS鏈接請使用標準的OSS域名,目前暫不支持綁定CDN域名和自定義域名。 |
400 | InvalidParameter | 參數錯誤,請根據算法API文檔和報錯Message檢查參數值。是否參數值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.BadRequest | 請求有誤,通常是請求參數不正確導致的,請檢查請求參數。 |
400 | InvalidParameter.Format | 待檢測內容格式錯誤,請確保待檢測的內容在API的限制范圍內。 |
400 | InvalidParameter.NotFound | 參數錯誤,請根據算法API文檔和報錯Message檢查參數值。是否參數值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.TooLarge | 待檢測內容過大,請確保待檢測的內容在API的限制范圍內。建議重試,若持續返回該錯誤碼,請通過釘釘群(23109592)聯系我們。 |
403 | InvalidRamRole | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,操作流程,請參見使用RAM Policy控制訪問權限。 |
400 | InvalidResult | 參數錯誤,請參考文檔檢查參數值,檢查文件內容。請檢查是否圖片內容不完整或者太模糊等。 |
400 | InvalidSide | Specified parameter Side is not valid. 請參考文檔填寫正確的Side參數 |
400 | InvalidTask.N.ImageTimeMillisecond | 參數Task.N.ImageTimeMillisecond取值無效。 |
400 | InvalidTimeStamp.Expired | 時間戳過期,請更新時間戳。 |
400 | MissingAccessKeyId | AccessKeyID未填寫,請檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | QuotaExceeded.ImageCount | 人臉、Trace數量超出限制。 |
449 | Retry | 由于網絡抖動等偶發原因導致失敗,需要重試。 |
400 | SDK.ServerUnreachable | SDK端錯誤。 |
503 | ServiceUnavailable | 服務不可用,如果服務器已經返回了RequestId,請通過釘釘群(23109592)聯系我們。 |
500 | ServiceUnavailable | 網絡請求錯誤。請優先檢查本地網絡是否存在故障,例如局域網絡等。如果服務器已經返回了RequestId,請通過釘釘群(23109592)聯系我們。 |
400 | SignatureDoesNotMatch | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,操作流程,請參見使用RAM Policy控制訪問權限。 |
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)中反饋問題。