本示例介绍如何使用Alibaba Cloud SDK for Java帮助您检测图片中是否含有风险内容。
背景信息
- 图片审核支持同步检测和异步检测两种方式。同步检测实时返回检测结果；异步检测需要您轮询结果或者通过callback回调通知获取检测结果。
- 图片支持传入互联网图片URL、本地图片文件路径以及二进制图片文件流。
前提条件
在使用本教程之前，请确保已完成以下操作：
- 使用Alibaba Cloud SDK for Java，您需要一个阿里云账号和访问密钥（AccessKey）。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey。
- 确保您已经安装了Alibaba Cloud SDK for Java，准确的SDK版本号，请参见 阿里云开发工具包（SDK）。
<dependencies> <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core --> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-core</artifactId> <version>4.4.3</version> </dependency> <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-green --> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-green</artifactId> <version>3.5.1</version> </dependency> <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-oss --> <dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>2.8.3</version> </dependency> <!-- https://mvnrepository.com/artifact/com.alibaba/fastjson --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.61</version> </dependency> </dependencies> - 如果使用本地文件或者二进制文件检测，请下载并在项目工程中引入Extension.Uploader工具类。
代码示例
- 直接传图片URL进行检测：
import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; import com.aliyuncs.CommonRequest; import com.aliyuncs.CommonResponse; import com.aliyuncs.DefaultAcsClient; import com.aliyuncs.IAcsClient; import com.aliyuncs.exceptions.ClientException; import com.aliyuncs.exceptions.ServerException; import com.aliyuncs.http.FormatType; import com.aliyuncs.http.MethodType; import com.aliyuncs.http.ProtocolType; import com.aliyuncs.profile.DefaultProfile; import java.util.Arrays; import java.util.Date; import java.util.UUID; public class Demo { public static void main(String[] args) { DefaultProfile profile = DefaultProfile.getProfile( "<your-region-id>", // 您的可用区ID "<your-access-key-id>", // 您的AccessKey ID "<your-access-key-secret>"); // 您的AccessKey Secret IAcsClient client = new DefaultAcsClient(profile); CommonRequest request = new CommonRequest(); // 指定请求方式 request.setSysMethod(MethodType.POST); // 指定请求地址 request.setSysDomain("green.cn-hangzhou.aliyuncs.com"); // 指定请求方法 request.setSysUriPattern("/green/image/scan"); // 指定请求版本 request.setSysVersion("2018-05-09"); // 支持HTTP和HTTPS request.setSysProtocol(ProtocolType.HTTPS); // 组装请求参数 JSONObject httpBody = new JSONObject(); // 设置要检测的场景, 计费是按照该处传递的场景进行 // 一次请求中可以同时检测多张图片，每张图片可以同时检测多个风险场景，计费按照场景计算 // 例如：检测2张图片，场景传递porn、terrorism，计费会按照2张图片鉴黄，2张图片暴恐检测计算 // porn: porn表示色情场景检测 httpBody.put("scenes", Arrays.asList("porn")); // 设置待检测图片， 一张图片一个task // 多张图片同时检测时，处理的时间由最后一个处理完的图片决定 // 通常情况下批量检测的平均rt比单张检测的要长, 一次批量提交的图片数越多，rt被拉长的概率越高 // 这里以单张图片检测作为示例, 如果是批量图片检测，请自行构建多个task JSONObject task = new JSONObject(); task.put("dataId", UUID.randomUUID().toString()); // 设置图片链接 task.put("url", "https://www.baidu.com/img/bd_logo1.png"); task.put("time", new Date()); httpBody.put("tasks", Arrays.asList(task)); request.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()), "UTF-8", FormatType.JSON); // 请设置超时时间, 服务端全链路处理超时时间为10秒，请做相应设置 // 如果您设置的ReadTimeout小于服务端处理的时间，程序中会获得一个read timeout异常 request.setSysConnectTimeout(3000); request.setSysReadTimeout(10000); CommonResponse httpResponse = null; try { CommonResponse response = client.getCommonResponse(request); JSONObject dataJson = JSON.parseObject(response.getData()); System.out.println(JSON.toJSONString(dataJson, true)); } catch (ServerException e) { e.printStackTrace(); } catch (ClientException e) { System.out.println("ErrCode:" + e.getErrCode()); System.out.println("ErrMsg:" + e.getErrMsg()); System.out.println("RequestId:" + e.getRequestId()); } } } - 上传图片二进制内容进行检测：
import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; import com.aliyuncs.CommonRequest; import com.aliyuncs.CommonResponse; import com.aliyuncs.DefaultAcsClient; import com.aliyuncs.IAcsClient; import com.aliyuncs.exceptions.ClientException; import com.aliyuncs.exceptions.ServerException; import com.aliyuncs.green.extension.uploader.ClientUploader; import com.aliyuncs.http.FormatType; import com.aliyuncs.http.MethodType; import com.aliyuncs.http.ProtocolType; import com.aliyuncs.profile.DefaultProfile; import org.apache.commons.codec.binary.StringUtils; import org.apache.commons.io.FileUtils; import java.io.File; import java.util.Arrays; import java.util.Date; import java.util.UUID; public class Demo { public static void main(String[] args) { DefaultProfile profile = DefaultProfile.getProfile( "<your-region-id>", // 您的可用区ID "<your-access-key-id>", // 您的AccessKey ID "<your-access-key-secret>"); // 您的AccessKey Secret IAcsClient client = new DefaultAcsClient(profile); CommonRequest request = new CommonRequest(); // 指定请求方式 request.setSysMethod(MethodType.POST); // 指定请求地址 request.setSysDomain("green.cn-hangzhou.aliyuncs.com"); // 指定请求方法 request.setSysUriPattern("/green/image/scan"); // 指定请求版本 request.setSysVersion("2018-05-09"); // 支持HTTP和HTTPS request.setSysProtocol(ProtocolType.HTTPS); JSONObject httpBody = new JSONObject(); // 设置要检测的场景, 计费是按照该处传递的场景进行 // 一次请求中可以同时检测多张图片，每张图片可以同时检测多个风险场景，计费按照场景计算 // 例如：检测2张图片，场景传递porn、terrorism，计费会按照2张图片鉴黄，2张图片暴恐检测计算 // porn: porn表示色情场景检测 httpBody.put("scenes", Arrays.asList("porn")); // 如果您要检测的文件存于本地服务器上，可以通过下述代码片生成url // 再将返回的url作为图片地址传递到服务端进行检测 String url = null; byte[] imageBytes = null; ClientUploader clientUploader = ClientUploader.getImageClientUploader(profile, false); try{ imageBytes = FileUtils.readFileToByteArray(new File("/Users.jpg")); //上传到服务端 url = clientUploader.uploadBytes(imageBytes); }catch (Exception e){ e.printStackTrace(); } // 设置待检测图片， 一张图片一个task // 多张图片同时检测时，处理的时间由最后一个处理完的图片决定 // 通常情况下批量检测的平均rt比单张检测的要长, 一次批量提交的图片数越多，rt被拉长的概率越高 // 这里以单张图片检测作为示例, 如果是批量图片检测，请自行构建多个task JSONObject task = new JSONObject(); task.put("dataId", UUID.randomUUID().toString()); //设置图片链接为上传后的url task.put("url", url); task.put("time", new Date()); httpBody.put("tasks", Arrays.asList(task)); request.setHttpContent(StringUtils.getBytesUtf8(httpBody.toJSONString()), "UTF-8", FormatType.JSON); // 请设置超时时间, 服务端全链路处理超时时间为10秒，请做相应设置 // 如果您设置的ReadTimeout小于服务端处理的时间，程序中会获得一个read timeout异常 request.setSysConnectTimeout(3000); request.setSysReadTimeout(10000); CommonResponse httpResponse = null; try { CommonResponse response = client.getCommonResponse(request); JSONObject dataJson = JSON.parseObject(response.getData()); System.out.println(JSON.toJSONString(dataJson, true)); } catch (ServerException e) { e.printStackTrace(); } catch (ClientException e) { System.out.println("ErrCode:" + e.getErrCode()); System.out.println("ErrMsg:" + e.getErrMsg()); System.out.println("RequestId:" + e.getRequestId()); } } }
执行结果
本文代码示例正确的返回结果类似如下：
{
"msg":"OK",
"code":200,
"data":[
{
"msg":"OK",
"code":200,
"dataId":"34061ac3-5f0f-4d19-b163-c05ea013cbc5",
"extras":{},
"results":[
{
"rate":100.0,
"suggestion":"pass",
"label":"normal",
"scene":"porn"
}
],
"taskId":"img6Ma******Eg-1rG71w",
"url":"http://aligre*****hanghai"
}
],
"requestId":"212963FE-FBFF-40DC-B86D-A8E192738DC6"
}