當API請求發生錯誤時,服務端會返回錯誤信息。本文為您介紹視頻生產API返回的錯誤碼信息。
阿里云視覺智能開放平臺各類目視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。
問題診斷中心
使用問題診斷中心可幫助開發者更高效地診斷API使用過程中的問題。
視頻生產錯誤碼
狀態碼 | 錯誤碼 | 描述 |
403 | AuthFailed | 授權失敗,請檢查RAM權限配置。 |
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.Busy | 算法服務忙。如有影響業務,請通過釘釘群(23109592)聯系我們。 |
500 | InternalError.Model | 模型加載錯誤,請稍后重。試如有影響業務,請通過釘釘群(23109592)聯系我們。 |
500 | 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 | 調用受限,請檢查您調用的能力是否為受限能力,受限能力需要在控制臺找到相應能力申請,經過審批或者手動激活之后才能調用。 如非上述情況,請檢查賬號是否欠費。 |
400 | InvalidApi.NotPurchase | 服務未開通,請先開通服務。 |
400 | InvalidApi.OutOfService | 產品未開通,請開通產品。 |
400 | InvalidFile.Category | 文件內容類目不符合要求。 |
400 | InvalidFile.Content | 數據為空或不適合被處理。 |
400 | InvalidFile.Decode | 文件無法解碼。 |
400 | InvalidFile.Download | 文件無法下載,請檢查本地網絡情況,以及鏈接是否可訪問。非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidFile.Region | 文件URL不屬于指定的Region。 |
400 | InvalidFile.Resolution | 文件分辨率非法。 |
400 | InvalidFile.Type | 文件類型錯誤,請檢查文件類型,參考算法API文檔,使用算法支持的文件類型。阿里云視覺智能開放平臺能夠讀取文件并獲取真實的文件類型,不是通過文件后綴名進行類型判斷,只看文件后綴名是無效的,關于更多文件類型判斷和處理信息,請參見文件類型判斷和處理。 |
400 | InvalidFile.Unsafe | 不安全的文件鏈接。 |
400 | InvalidFile.URL | 非法的文件URL。 |
400 | InvalidImage.Content | 請參考算法文檔檢查圖片內容,更換包含符合算法要求的圖片。 |
400 | InvalidImage.Decode | 請檢查圖片是否能夠正常打開。 |
400 | InvalidImage.Download | 圖片無法下載,請檢查本地網絡情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS圖片鏈接,請參見文件URL處理。URL中不支持空格和中文字符,如包含請通過URLEncode編碼之后再傳入。 |
404 | InvalidImage.NotFoundFace | 圖像中沒找到人臉,請檢查您的圖像中是否包含人臉或人臉太小。 |
400 | InvalidImage.REGION | 圖片鏈接地域錯誤,非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidImage.Resolution | 文件分辨率超出限制,請檢查文件分辨率和內容,修改文件分辨率后重試。 |
400 | InvalidImage.Timeout | 圖片下載超時,請檢查本地網絡情況、鏈接是否可訪問、OSS鏈接是否過期等。非上海OSS文件鏈接,請參見文件URL處理。 |
400 | InvalidImage.Type | 圖片類型錯誤,請檢查圖片類型,參考算法API文檔,使用算法支持的圖片類型。 |
400 | InvalidImage.URL | 圖片鏈接非法,請檢查圖片鏈接是否可訪問,非上海OSS圖片鏈接,請參見文件URL處理。對于上海OSS鏈接請使用標準的OSS域名,目前暫不支持綁定CDN域名和自定義域名。 |
400 | InvalidParameter | 入參非法。 |
400 | InvalidParameter.BadRequest | 入參缺失或非法。 |
400 | InvalidParameter.Format | 入參格式錯誤。 |
400 | InvalidParameter.NotFound | 參數錯誤,請根據算法API文檔和報錯Message檢查參數值。是否參數值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.TooLarge | 參數錯誤,文件大小超出限制,請參考算法API文檔調整文件大小。 |
400 | InvalidRamRole | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,操作流程,請參見使用RAM Policy控制訪問權限。 |
400 | InvalidResult | 參數錯誤,請參考文檔檢查參數值,檢查文件內容。請檢查是否圖片內容不完整或者太模糊等。 |
400 | InvalidSide | Specified parameter Side is not valid. 請參考文檔填寫正確的Side參數。 |
400 | InvalidTimeStamp.Expired | 時間戳過期,請更新時間戳。 |
400 | MissingAccessKeyId | AccessKeyID未填寫,請檢查AccessKeyID和AccessKeySecret是否填寫正確。 |
400 | MissingParameter | 入參缺失。 |
400 | ParameterError | 參數錯誤,請檢查參數值。 |
503 | ServiceUnavailable | 服務不可用,如果服務器已經返回了RequestId,請通過釘釘群(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 | 請求超時。 |
400 | Unauthorized | 沒有RAM權限,請聯系主賬號給您添加AliyunVIAPIFullAccess權限,操作流程,請參見使用RAM Policy控制訪問權限。 |
公共錯誤碼
API的公共錯誤碼請參見API錯誤中心。
處理建議
請求服務出現錯誤碼提示,請參見錯誤碼描述查看具體錯誤原因,并進行錯誤處理。針對一些常見高頻的錯誤類型,此處提供一些錯誤處理建議供您參考。
URL類錯誤碼
此類錯誤碼一般都是文件URL不符合要求,例如URL不安全、無效。更多信息,請參見文件URL處理。
圖像加載錯誤碼
此類錯誤也可以看作是圖像URL錯誤,例如圖像下載錯誤、地域錯誤。當前系統推薦使用華東2(上海)地域,如果您通過OSS生成URL,那么您在OSS上創建的Bucket所屬地域應該為華東2(上海)。更多信息,請參見文件URL處理。
參數類錯誤碼
此類錯誤碼一般是輸入參數不符合要求,例如參數缺失、參數類型錯誤等。建議您檢查輸入參數是否符合要求,您可以參考對應API文檔中的請求參數表格進行檢查確認。
系統服務類錯誤碼
如果出現此類錯誤碼,建議您重新發起服務請求,如果問題依然存在,請在釘釘群組(23109592)中反饋問題。