全部產品
Search

搜尋本產品

    Content Moderation：圖片審核

    文件中心

    Content Moderation：圖片審核

    更新時間：Jul 06, 2024

    本文介紹了如何使用Java SDK圖片審核介面，檢測圖片中是否包含風險內容。

    功能描述

    圖片審核支援同步檢測和非同步檢測兩種方式。

    • 同步檢測即時返回檢測結果。關於參數的詳細資料，請參見同步檢測。

    • 非同步檢測需要您輪詢結果或者通過callback回調通知擷取檢測結果。關於參數的詳細資料，請參見非同步檢測。

    前提條件

    • 安裝Java依賴。關於安裝Java依賴的具體操作，請參見安裝Java依賴。

      說明

      請一定按照安裝Java依賴頁面中的版本安裝，否則會導致調用失敗。

    • 如果使用本地檔案或者二進位檔案檢測，請下載並在專案工程中引入Extension.Uploader工具類。

    （推薦）提交圖片同步檢測任務

    介面

    描述

    支援的地區

    ImageSyncScanRequest

    提交圖片同步檢測任務，對圖片進行多個風險情境的識別，包括色情、暴恐涉政、廣告、二維碼、不良情境、Logo（商標台標）識別。

    • cn-shanghai：華東2（上海）

    • cn-beijing：華北2（北京）

    • cn-shenzhen：華南1（深圳）

    • ap-southeast-1：新加坡

    範例程式碼

    • 傳圖片URL進行檢測 

      import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.model.v20180509.ImageSyncScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.*;

public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageSyncScanRequest imageSyncScanRequest = new ImageSyncScanRequest();
        // 指定API返回格式。
        imageSyncScanRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageSyncScanRequest.setMethod(MethodType.POST);
        imageSyncScanRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageSyncScanRequest.setProtocol(ProtocolType.HTTP);

        JSONObject httpBody = new JSONObject();
        /**
         * 設定要檢測的風險情境。計費依據此處傳遞的情境計算。
         * 一次請求中可以同時檢測多張圖片，每張圖片可以同時檢測多個風險情境，計費按照情境計算。
         * 例如，檢測2張圖片，情境傳遞porn和terrorism，計費會按照2張圖片鑒黃，2張圖片暴恐檢測計算。
         * porn：表示鑒黃情境。
         */
        httpBody.put("scenes", Arrays.asList("porn"));

        /**
         * 設定待檢測圖片。一張圖片對應一個task。
         * 多張圖片同時檢測時，處理的時間由最後一個處理完的圖片決定。
         * 通常情況下批量檢測的平均回應時間比單張檢測的要長。一次批量提交的圖片數越多，回應時間被拉長的機率越高。
         * 這裡以單張圖片檢測作為樣本, 如果是批量圖片檢測，請自行構建多個task。
         */
        JSONObject task = new JSONObject();
        task.put("dataId", UUID.randomUUID().toString());

        // 設定圖片連結。URL中有特殊字元，需要對URL進行encode編碼。
        task.put("url", "http://www.aliyundoc.com/xxx.test.jpg");
        task.put("time", new Date());
        httpBody.put("tasks", Arrays.asList(task));

        imageSyncScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
            "UTF-8", FormatType.JSON);

        /**
         * 請設定逾時時間。服務端全鏈路處理逾時時間為10秒，請做相應設定。
         * 如果您設定的ReadTimeout小於服務端處理的時間，程式中會獲得一個ReadTimeout異常。
         */
        imageSyncScanRequest.setConnectTimeout(3000);
        imageSyncScanRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(imageSyncScanRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        // 服務端接收到請求，完成處理後返回的結果。
        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
            int requestCode = scrResponse.getIntValue("code");
            // 每一張圖片的檢測結果。
            JSONArray taskResults = scrResponse.getJSONArray("data");
            if (200 == requestCode) {
                for (Object taskResult : taskResults) {
                    // 單張圖片的處理結果。
                    int taskCode = ((JSONObject) taskResult).getIntValue("code");
                    // 圖片對應檢測情境的處理結果。如果是多個情境，則會有每個情境的結果。
                    JSONArray sceneResults = ((JSONObject) taskResult).getJSONArray("results");
                    if (200 == taskCode) {
                        for (Object sceneResult : sceneResults) {
                            String scene = ((JSONObject) sceneResult).getString("scene");
                            String suggestion = ((JSONObject) sceneResult).getString("suggestion");
                            // 根據scene和suggestion做相關處理。
                            // 根據不同的suggestion結果做業務上的不同處理。例如，將違規資料刪除等。
                            System.out.println("scene = [" + scene + "]");
                            System.out.println("suggestion = [" + suggestion + "]");
                        }
                    } else {
                        // 單張圖片處理失敗, 原因視具體的情況詳細分析。
                        System.out.println("task process fail. task response:" + JSON.toJSONString(taskResult));
                    }
                }
            } else {
                /**
                 * 表明請求整體處理失敗，原因視具體的情況詳細分析。
                 */
                System.out.println("the whole image scan request failed. response:" + JSON.toJSONString(scrResponse));
            }
        }
    }

}

    • 傳本地圖片檔案進行檢測 

      import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.extension.uploader.ClientUploader;
import com.aliyuncs.green.model.v20180509.ImageSyncScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.*;

public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageSyncScanRequest imageSyncScanRequest = new ImageSyncScanRequest();
        // 指定API返回格式。
        imageSyncScanRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageSyncScanRequest.setMethod(MethodType.POST);
        imageSyncScanRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageSyncScanRequest.setProtocol(ProtocolType.HTTP);


        JSONObject httpBody = new JSONObject();
        /**
         * 設定要檢測的情境。計費依據此處傳遞的情境計算。
         * 一次請求中可以同時檢測多張圖片，每張圖片可以同時檢測多個風險情境，計費按照情境計算。
         * 例如：檢測2張圖片，情境傳遞porn和terrorism，計費會按照2張圖片鑒黃，2張圖片暴恐檢測計算。
         * porn：表示色情情境檢測。
         */
        httpBody.put("scenes", Arrays.asList("porn"));

        /**
         * 如果您要檢測的檔案存於本機伺服器上，可以通過下述代碼片產生URL。
         * 再將返回的URL作為圖片地址傳遞到服務端進行檢測。
         */
        String url = null;
        ClientUploader clientUploader = ClientUploader.getImageClientUploader(profile, false);
        try{
            url = clientUploader.uploadFile("d:/test.jpg");
        }catch (Exception e){
            e.printStackTrace();
        }

        /**
         * 設定待檢測圖片。一張圖片對應一個task。
         * 多張圖片同時檢測時，處理的時間由最後一個處理完的圖片決定。
         * 通常情況下批量檢測的平均回應時間比單張檢測的要長，一次批量提交的圖片數越多，回應時間被拉長的機率越高。
         * 這裡以單張圖片檢測作為樣本。如果是批量圖片檢測，請自行構建多個task。
         */
        JSONObject task = new JSONObject();
        task.put("dataId", UUID.randomUUID().toString());

        // 設定圖片連結為上傳後的URL。URL中有特殊字元，需要對URL進行encode編碼。
        task.put("url", url);
        task.put("time", new Date());
        httpBody.put("tasks", Arrays.asList(task));

        imageSyncScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
            "UTF-8", FormatType.JSON);

        /**
         * 請設定逾時時間。服務端全鏈路處理逾時時間為10秒，請做相應設定。
         * 如果您設定的ReadTimeout小於服務端處理的時間，程式中會獲得一個ReadTimeout異常。
         */
        imageSyncScanRequest.setConnectTimeout(3000);
        imageSyncScanRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(imageSyncScanRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        // 服務端接收到請求，並完成處理後返回的結果。
        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
            int requestCode = scrResponse.getIntValue("code");
            // 每一張圖片的檢測結果。
            JSONArray taskResults = scrResponse.getJSONArray("data");
            if (200 == requestCode) {
                for (Object taskResult : taskResults) {
                    // 單張圖片的處理結果。
                    int taskCode = ((JSONObject) taskResult).getIntValue("code");
                    // 圖片對應檢測情境的處理結果。如果是多個情境，則會有每個情境的結果。
                    JSONArray sceneResults = ((JSONObject) taskResult).getJSONArray("results");
                    if (200 == taskCode) {
                        for (Object sceneResult : sceneResults) {
                            String scene = ((JSONObject) sceneResult).getString("scene");
                            String suggestion = ((JSONObject) sceneResult).getString("suggestion");
                            // 根據scene和suggestion做相關處理。
                            // 根據不同的suggestion結果做業務上的不同處理。例如，將違規資料刪除等。
                            System.out.println("scene = [" + scene + "]");
                            System.out.println("suggestion = [" + suggestion + "]");
                        }
                    } else {
                        // 單張圖片處理失敗，原因視具體的情況詳細分析。
                        System.out.println("task process fail. task response:" + JSON.toJSONString(taskResult));
                    }
                }
            } else {
                /**
                 * 表明請求整體處理失敗，原因視具體的情況詳細分析。
                 */
                System.out.println("the whole image scan request failed. response:" + JSON.toJSONString(scrResponse));
            }
        }
    }

}

    • 傳圖片二進位內容進行檢測 

      import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.extension.uploader.ClientUploader;
import com.aliyuncs.green.model.v20180509.ImageSyncScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import org.apache.commons.io.FileUtils;

import java.io.File;
import java.util.*;

public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageSyncScanRequest imageSyncScanRequest = new ImageSyncScanRequest();
        // 指定API返回格式。
        imageSyncScanRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageSyncScanRequest.setMethod(MethodType.POST);
        imageSyncScanRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageSyncScanRequest.setProtocol(ProtocolType.HTTP);


        JSONObject httpBody = new JSONObject();
        /**
         * 設定要檢測的情境。計費依據此處傳遞的情境計算。
         * 一次請求中可以同時檢測多張圖片，每張圖片可以同時檢測多個風險情境，計費按照情境計算。
         * 例如，檢測2張圖片，情境傳遞porn和terrorism，計費會按照2張圖片鑒黃，2張圖片暴恐檢測計算。
         * porn：表示色情情境檢測。
         */
        httpBody.put("scenes", Arrays.asList("porn"));

        /**
         * 如果您要檢測的檔案存於本機伺服器上，可以通過下述代碼片產生URL。
         * 再將返回的URL作為圖片地址傳遞到服務端進行檢測。
         */
        ClientUploader clientUploader = ClientUploader.getImageClientUploader(profile, false);
        byte[] imageBytes = null;
        String url = null;
        try{
            // 這裡讀取本地檔案作為位元據，當做輸入做為樣本。實際使用中請直接替換成您的圖片位元據。
            imageBytes = FileUtils.readFileToByteArray(new File("/Users/01fb4ab6420b5f34623e13b82b51ef87.jpg"));
            // 上傳到服務端。
            url = clientUploader.uploadBytes(imageBytes);
        }catch (Exception e){
            e.printStackTrace();
            throw e;
        }

        /**
         * 設定待檢測圖片。一張圖片對應一個task。
         * 多張圖片同時檢測時，處理的時間由最後一個處理完的圖片決定。
         * 通常情況下批量檢測的平均回應時間比單張檢測的要長，一次批量提交的圖片數越多，回應時間被拉長的機率越高。
         * 這裡以單張圖片檢測作為樣本。如果是批量圖片檢測，請自行構建多個task。
         */
        JSONObject task = new JSONObject();
        task.put("dataId", UUID.randomUUID().toString());

        // 設定圖片連結為上傳後的URL。URL中有特殊字元，需要對URL進行encode編碼。
        task.put("url", url);
        task.put("time", new Date());
        httpBody.put("tasks", Arrays.asList(task));

        imageSyncScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
            "UTF-8", FormatType.JSON);

        /**
         * 請設定逾時時間。服務端全鏈路處理逾時時間為10秒，請做相應設定。
         * 如果您設定的ReadTimeout小於服務端處理的時間，程式中會獲得一個ReadTimeout異常。
         */
        imageSyncScanRequest.setConnectTimeout(3000);
        imageSyncScanRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(imageSyncScanRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        // 服務端接收到請求，完成處理後返回的結果。
        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
            int requestCode = scrResponse.getIntValue("code");
            // 每一張圖片的檢測結果。
            JSONArray taskResults = scrResponse.getJSONArray("data");
            if (200 == requestCode) {
                for (Object taskResult : taskResults) {
                    // 單張圖片的處理結果。
                    int taskCode = ((JSONObject) taskResult).getIntValue("code");
                    // 圖片對應檢測情境的處理結果。如果是多個情境，則會有每個情境的結果。
                    JSONArray sceneResults = ((JSONObject) taskResult).getJSONArray("results");
                    if (200 == taskCode) {
                        for (Object sceneResult : sceneResults) {
                            String scene = ((JSONObject) sceneResult).getString("scene");
                            String suggestion = ((JSONObject) sceneResult).getString("suggestion");
                            // 根據scene和suggestion做相關處理。
                            // 根據不同的suggestion結果做業務上的不同處理。例如，將違規資料刪除等。
                            System.out.println("scene = [" + scene + "]");
                            System.out.println("suggestion = [" + suggestion + "]");
                        }
                    } else {
                        // 單張圖片處理失敗，原因視具體的情況詳細分析。
                        System.out.println("task process fail. task response:" + JSON.toJSONString(taskResult));
                    }
                }
            } else {
                /**
                 * 表明請求整體處理失敗，原因視具體的情況詳細分析。
                 */
                System.out.println("the whole image scan request failed. response:" + JSON.toJSONString(scrResponse));
            }
        }
    }

}

    提交圖片非同步檢測任務

    使用Java SDK對圖片進行風險檢測。通過非同步請求提交檢測任務，結果可以通過提交請求時設定callback，也可以通過ImageAsyncScanResultsRequest介面輪詢。

    非同步檢測支援的輸入內容與同步檢測一致（本地檔案、圖片URL、圖片二進位流），以下僅以圖片URL作為輸入樣本。

    介面

    描述

    支援的地區

    ImageAsyncScanRequest

    提交圖片非同步檢測任務，對圖片進行多個風險情境的識別，包括色情、暴恐涉政、廣告、二維碼、不良情境、Logo（商標台標）識別。

    • cn-shanghai：華東2（上海）

    • cn-beijing：華北2（北京）

    • cn-shenzhen：華南1（深圳）

    • ap-southeast-1：新加坡

    範例程式碼 

    import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.model.v20180509.ImageAsyncScanRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.Arrays;
import java.util.Date;
import java.util.UUID;

public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageAsyncScanRequest imageAsyncScanRequest = new ImageAsyncScanRequest();
        // 指定API返回格式。
        imageAsyncScanRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageAsyncScanRequest.setMethod(MethodType.POST);
        imageAsyncScanRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageAsyncScanRequest.setProtocol(ProtocolType.HTTP);


        JSONObject httpBody = new JSONObject();
        /**
         * 設定要檢測的情境。計費依據此處傳遞的情境計算。
         * 一次請求中可以同時檢測多張圖片，每張圖片可以同時檢測多個風險情境，計費按照情境計算。
         * 例如：檢測2張圖片，情境傳遞porn和terrorism，計費會按照2張圖片鑒黃，2張圖片暴恐檢測計算。
         * porn：表示色情情境檢測。
         */
        httpBody.put("scenes", Arrays.asList("porn"));
        httpBody.put("callback", "http://www.aliyundoc.com/xxx.json");
        httpBody.put("seed", "yourPersonalSeed");

        /**
         * 設定待檢測圖片。一張圖片對應一個task。最多支援50張圖片同時檢測，即需要構建50個task。
         * 多張圖片同時檢測時，處理的時間由最後一個處理完的圖片決定。
         * 通常情況下批量檢測的平均回應時間比單張檢測的要長，一次批量提交的圖片數越多，回應時間被拉長的機率越高。
         * 這裡以單張圖片檢測作為樣本。如果是批量圖片檢測，請自行構建多個task。
         */
        JSONObject task = new JSONObject();
        task.put("dataId", UUID.randomUUID().toString());

        // 設定圖片連結。URL中有特殊字元，需要對URL進行encode編碼。
        task.put("url", "http://www.aliyundoc.com/xxx.test.jpg");
        task.put("time", new Date());
        httpBody.put("tasks", Arrays.asList(task));

        imageAsyncScanRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
            "UTF-8", FormatType.JSON);

        /**
         * 請設定逾時時間。服務端全鏈路處理逾時時間為10秒，請做相應設定。
         * 如果您設定的ReadTimeout小於服務端處理的時間，程式中會獲得一個ReadTimeout異常。
         */
        imageAsyncScanRequest.setConnectTimeout(3000);
        imageAsyncScanRequest.setReadTimeout(10000);
        HttpResponse httpResponse = null;
        try {
            httpResponse = client.doAction(imageAsyncScanRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }

        // 服務端接收到請求，完成處理後返回的結果。
        if (httpResponse != null && httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(org.apache.commons.codec.binary.StringUtils.newStringUtf8(httpResponse.getHttpContent()));
            System.out.println(JSON.toJSONString(scrResponse, true));
            int requestCode = scrResponse.getIntValue("code");
            // 每一張圖片的檢測結果。
            JSONArray taskResults = scrResponse.getJSONArray("data");
            if (200 == requestCode) {
                for (Object taskResult : taskResults) {
                    // 單張圖片的處理結果。
                    int taskCode = ((JSONObject) taskResult).getIntValue("code");
                    // 圖片要檢測的情境的處理結果，如果是多個情境，則會有每個情境的結果。
                    JSONArray sceneResults = ((JSONObject) taskResult).getJSONArray("results");
                    if (200 == taskCode) {
                        // 儲存taskId用於輪詢結果。
                        System.out.println(((JSONObject)taskResult).getString("taskId"));
                    } else {
                        // 單張圖片處理失敗，原因視具體的情況詳細分析。
                        System.out.println("task process fail. task response:" + JSON.toJSONString(taskResult));
                    }
                }
            } else {
                /**
                 * 表明請求整體處理失敗，原因視具體的情況詳細分析。
                 */
                System.out.println("the whole image scan request failed. response:" + JSON.toJSONString(scrResponse));
            }
        }
    }
}

    查詢圖片非同步檢測結果

    介面

    描述

    支援的地區

    ImageAsyncScanResultsRequest

    查詢圖片非同步檢測任務的結果。支援同時查詢多個檢測任務的返回結果。

    • cn-shanghai：華東2（上海）

    • cn-beijing：華北2（北京）

    • cn-shenzhen：華南1（深圳）

    • ap-southeast-1：新加坡

    範例程式碼 

    import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.green.model.v20180509.ImageAsyncScanRequest;
import com.aliyuncs.green.model.v20180509.ImageAsyncScanResultsRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.*;

public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageAsyncScanResultsRequest imageAsyncScanResultsRequest = new ImageAsyncScanResultsRequest();
        // 指定API返回格式。
        imageAsyncScanResultsRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageAsyncScanResultsRequest.setMethod(MethodType.POST);
        imageAsyncScanResultsRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageAsyncScanResultsRequest.setProtocol(ProtocolType.HTTP);


        List<String> taskIds = new ArrayList<String>();
        taskIds.add("img4hDosCHcrFk5jAMR80XWJN-1pZ@0p");
        imageAsyncScanResultsRequest.setHttpContent(JSON.toJSONString(taskIds).getBytes("UTF-8"), "UTF-8", FormatType.JSON);

        /**
         * 請務必設定逾時時間。
         */
        imageAsyncScanResultsRequest.setConnectTimeout(3000);
        imageAsyncScanResultsRequest.setReadTimeout(6000);

        try {
            HttpResponse httpResponse = client.doAction(imageAsyncScanResultsRequest);

            if(httpResponse.isSuccess()){
                JSONObject scrResponse = JSON.parseObject(new String(httpResponse.getHttpContent(), "UTF-8"));
                System.out.println(JSON.toJSONString(scrResponse, true));
                if (200 == scrResponse.getInteger("code")) {
                    JSONArray taskResults = scrResponse.getJSONArray("data");
                    for (Object taskResult : taskResults) {
                        if(200 == ((JSONObject)taskResult).getInteger("code")){
                            JSONArray sceneResults = ((JSONObject)taskResult).getJSONArray("results");
                            for (Object sceneResult : sceneResults) {
                                String scene = ((JSONObject)sceneResult).getString("scene");
                                String suggestion = ((JSONObject)sceneResult).getString("suggestion");
                                // 根據scene和suggestion做相關的處理。
                                // 根據不同的suggestion結果做業務上的不同處理。例如，將違規資料刪除等。
                            }
                        }else{
                            System.out.println("task process fail:" + ((JSONObject)taskResult).getInteger("code"));
                        }
                    }
                } else {
                    System.out.println("detect not success. code:" + scrResponse.getInteger("code"));
                }
            }else{
                System.out.println("response not success. status:" + httpResponse.getStatus());
            }
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        } catch (Exception e){
            e.printStackTrace();
        }
    }
}

    圖片檢測結果反饋

    如果您認為圖片檢測結果與您的預期不符，可以通過圖片檢測結果反饋介面，對檢測結果進行糾正（系統會根據您反饋的結果，將圖片添加到相似圖片的黑名單庫或者白名單庫）。當您再次提交相似的內容進行檢測時，以您反饋的label返回結果。

    關於介面的說明，請參見檢測結果反饋。

    介面

    描述

    支援的Region

    ImageScanFeedbackRequest

    提交圖片檢測結果的反饋，以人工反饋的檢測結果糾正演算法檢測結果。

    • cn-shanghai：華東2（上海）

    • cn-beijing：華北2（北京）

    • cn-shenzhen：華南1（深圳）

    • ap-southeast-1：新加坡

    範例程式碼

    import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.green.model.v20180509.ImageScanFeedbackRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

import java.util.Arrays;


public class Main {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。 
         * 常見擷取環境變數方式：
         * 方式一：
         *     擷取RAM使用者AccessKey ID：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二：
         *     擷取RAM使用者AccessKey ID：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     擷取RAM使用者AccessKey Secret：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建議從環境變數中擷取RAM使用者AccessKey ID",
                "建議從環境變數中擷取RAM使用者AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意：此處執行個體化的client儘可能重複使用，提升檢測效能。避免重複建立串連。
        IAcsClient client = new DefaultAcsClient(profile);

        ImageScanFeedbackRequest imageScanFeedbackRequest = new ImageScanFeedbackRequest();
        // 指定API返回格式。
        imageScanFeedbackRequest.setAcceptFormat(FormatType.JSON);
        // 指定要求方法。
        imageScanFeedbackRequest.setMethod(MethodType.POST);
        imageScanFeedbackRequest.setEncoding("utf-8");
        // 支援HTTP和HTTPS。
        imageScanFeedbackRequest.setProtocol(ProtocolType.HTTP);

        // scenes：檢測情境，支援指定多個情境。
        // suggestion：期望的檢測結果。pass：正常；block：違規。
        JSONObject httpBody = new JSONObject();
        httpBody.put("suggestion", "block");
        httpBody.put("scenes", Arrays.asList("ad", "terrorism"));
        httpBody.put("url", "圖片連結");

        imageScanFeedbackRequest.setHttpContent(org.apache.commons.codec.binary.StringUtils.getBytesUtf8(httpBody.toJSONString()),
                "UTF-8", FormatType.JSON);

        imageScanFeedbackRequest.setConnectTimeout(3000);
        imageScanFeedbackRequest.setReadTimeout(10000);
        try {
            HttpResponse httpResponse = client.doAction(imageScanFeedbackRequest);
            if (httpResponse.isSuccess()) {
                JSONObject scrResponse = JSON.parseObject(new String(httpResponse.getHttpContent(), "UTF-8"));
                System.out.println(JSON.toJSONString(scrResponse, true));
                if (200 == scrResponse.getInteger("code")) {
                    // 調用成功。
                } else {
                    System.out.println("detect not success. code:" + scrResponse.getInteger("code"));
                }
            } else {
                System.out.println("response not success. status:" + httpResponse.getStatus());
            }
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}