ImageDetectionRequest__SDK·接口介紹_內容檢測API文檔_阿裏綠網-阿裏雲

圖片檢測請使用SDK中名為 ImageDetectionRequest 接口進行開發.

圖像檢測接口: 支持同步和異步檢測兩種方式.

異步檢測時:不會實時返回圖像檢測結果，需要在1分鍾後調用獲取異步圖像檢測結果接口來獲取最終檢測結果，適合於圖片量較大的用戶來使用，單次調用支持最多50張圖片，支持的場景包括: 黃圖檢測(porn)、ocr檢測(ocr)、暴恐敏感檢測(illegal). 需要配合ImageResultsRequest來獲取檢測結果. 異步接口支持http回調，您需要將回調的http接口傳遞給我們，詳情參見NotifyUrl、NotifySeed兩個參數的描述.
同步檢測時: 能夠實時返回圖像檢測的接口，單次調用隻支持單張圖片調用，支持的場景包括: 黃圖檢測(porn)、ocr檢測(ocr)、暴恐敏感檢測(illegal).

屬性	值類型	必須	說明
ImageUrl	List<String>	是	需要檢測的圖像URL，目前隻支持http、https協議的圖像URL。支持多張圖像上傳，最大支持50張圖像。圖片隻支持靜態圖片格式如：PNG,JPG,JPEG,BMP，不支持GIF圖片。
Async	boolean	否	是否同步調用。這裏設置成true
Scene	List<String>	是	場景ID，不同場景代表使用不同算法。目前支持如下場景：porn(色情圖像識別)、illegal(暴恐敏感圖像識別)、ocr(圖像字符識別)。支持多場景組合使用，即在List中同時設置多個場景ID
NotifyUrl	String	否	回調通知鏈接，設置該鏈接後，係統會通過該鏈接主動將檢測結果通知給用戶, 支持http和https
NotifySeed	String	否	回調通知種子，我們將通過該種子生產一個checksum，以防非法用戶對通知結果進行篡改

結果說明(返回結果為JSON字符串)

屬性	值類型	值示例	說明
Code	String	Success	返回狀態碼，Success表示調用成功。如果不為Success則表示調用出錯，錯誤消息可以參考msg
Msg String	Request Success	返回消息。如果code不為Success的時候，描述詳細錯誤信息
ImageResults	List<ImageResult>		圖片異步檢測接收列表。每個元素是一個圖片的接收結果(map對象)，包含兩個key-value對：{“ImageName”:”imgName1”, “TaskId”:”babac802-195d-4406-9cf7-38d71e516ed7-1450776115827”}。image_name是圖片名字，task_id是圖片檢測任務id(根據該id從讀取圖片檢測結果接口獲取檢測結果)

注: 異步圖像檢測接口將會正對每一張檢測的圖片返回一個TaskId 需要根據這個TaskId調用獲取異步圖像檢測結果接口來獲取圖片檢測的最終結果, 請參考: 圖像異步檢測結果獲取接口的說明

如果設置了通知鏈接，需支持post方法, 係統將按一下格式返回通知內容, 通過http 200返回狀態碼判斷推送成功，編碼采用utf-8

屬性	值類型	說明
checksum	String	由用戶uid + notifyseed + content拚成字符串，通過sha256算法生產
content	String	JSON字符串格式, 請自行解析成反轉成json對象

content 值內容格式如下

屬性	值類型	值示例	說明
code	String	Success	返回狀態碼，Success表示調用成功。如果不為Success則表示調用出錯，錯誤消息可以參考msg
msg	String	Request Success	返回消息。如果code不為Success的時候，描述詳細錯誤信息
status	String	任務狀態
image	Object		圖片檢測結果列表，每個元素是一個圖片的檢測結果。詳見下麵圖片Object的描述

圖片檢測結果ImageResult描述

屬性	值類型	說明
TaskId	String	圖片檢測的任務ID
PornResult	Object	色情圖像識別結果，json對象。包含兩個key-value對：{“label”:1, “rate”:100}。rate是0~100範圍的一個浮點值，越接近100，表示色情圖像的概率越高（精度到小數點後2位）。label是建議值，0表示正常，1表示色情，2表示未確認。用戶可以根據自己的場景采信這個值（注：綠網會根據圖片樣本的不斷積累，動態調整建議值的閾值設定）
IllegalResult	Object	暴恐敏感圖像識別結果，json對象。包含兩個key-value對：{“label”:0, “rate”:0}。rate是0~100範圍的一個浮點值，越接近100，表示違規圖像的概率越高（精度到小數點後2位）。label是建議值，0表示正常，1表示違規，2表示未確認。用戶可以根據自己的場景采信這個值。（注：綠網會根據圖片樣本的不斷積累，動態調整建議值的閾值設定）
OcrResult	Object	圖像字符識別結果，json對象。包含一個key-value對：{“text”:[“圖片中的文字”]}。text是字符串列表，內容是圖像中文字的主要段落內容（按照概率輸出最多5組概率最大的組合）

最後更新：2016-12-19 20:43:34