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