AI Guardrails:Document Moderation 2.0 SDK

公開ドキュメントのモデレーション

利用シーン

ファイルモデレーション 2.0 サービスは、URL から公開ドキュメントをフェッチすることでモデレーションを実行できます。

Maven プロジェクトで SDK を使用するには、pom.xml ファイルに依存関係を追加します。

1. dependencies セクションに以下の依存関係を追加します。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>3.3.3</version>
   </dependency>

2. Java SDK を統合します。

   • ドキュメント検出タスクを送信するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.FileModerationRequest; 
     import com.aliyun.green20220302.models.FileModerationResponse; 
     import com.aliyun.green20220302.models.FileModerationResponseBody; 
     import com.aliyun.teaopenapi.models.Config;
     
     public class FileModerationDemo {
         public static void main(String[] args) throws Exception {
             Config config = new Config();
              /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
              * 環境変数を取得する一般的な方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("YOUR_ACCESS_KEY_ID");
             config.setAccessKeySecret("YOUR_ACCESS_KEY_SECRET");
             // 必要に応じてリージョンとエンドポイントを変更します。
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // 読み取りタイムアウト。単位：ミリ秒 (ms)。
             config.setReadTimeout(6000);
             // 接続タイムアウト。単位：ミリ秒 (ms)。
             config.setConnectTimeout(3000);
     
             Client client = new Client(config);
             JSONObject serviceParameters = new JSONObject();
             serviceParameters.put("url", "https://xxx.oss.aliyuncs.com/xxx.pdf"); // ファイルの URL。
     
             FileModerationRequest fileModerationRequest = new FileModerationRequest(); 
             // 検出サービスを指定：一般ドキュメント検出の場合は document_detection_global。
             fileModerationRequest.setService("document_detection_global");
             fileModerationRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 FileModerationResponse response = client.fileModeration(fileModerationRequest); 
                 if (response.getStatusCode() == 200) {
                     FileModerationResponseBody result = response.getBody(); 
                     System.out.println(JSON.toJSONString(result));
                     System.out.println("requestId = " + result.getRequestId());
                     System.out.println("code = " + result.getCode());
                     System.out.println("msg = " + result.getMessage());
                     Integer code = result.getCode();
                     if (200 == code) {
                         FileModerationResponseBody.FileModerationResponseBodyData data = result.getData();
                         System.out.println("taskId = [" + data.getTaskId() + "]");
                     } else {
                         System.out.println("File moderation failed. Code: " + code);
                     }
                 } else {
                     System.out.println("The response was unsuccessful. Status: " + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • ドキュメント検出結果を取得するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
              * 環境変数を取得する一般的な方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("YOUR_ACCESS_KEY_ID");
             config.setAccessKeySecret("YOUR_ACCESS_KEY_SECRET");
             // 必要に応じてリージョンとエンドポイントを変更します。
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // 読み取りタイムアウト。単位：ミリ秒 (ms)。
             config.setReadTimeout(6000);
             // 接続タイムアウト。単位：ミリ秒 (ms)。
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // モデレーションタスクを送信後に返されたタスク ID。
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         System.out.println("Querying the file moderation result failed. Code: " + result.getCode());
                     }
                 } else {
                     System.out.println("The response was unsuccessful. Status: " + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

ローカルドキュメントのスキャン

利用シーン

パブリック URL を持たないローカルマシンに保存されているドキュメントをモデレーションする必要がある場合は、Object Storage Service (OSS) バケットにアップロードします。ファイルモデレーション 2.0 サービスは、OSS バケットからドキュメントにアクセスしてモデレーションを実行できます。

1. dependencies セクションに以下の依存関係を追加します。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>3.3.3</version>
   </dependency>

   OSS SDK の依存関係を追加します。

   <dependency>
     <groupId>com.aliyun.oss</groupId>
     <artifactId>aliyun-sdk-oss</artifactId>
     <version>3.16.3</version>
   </dependency>

2. Java SDK を統合します。

   • ファイルモデレーションタスクを送信するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeUploadTokenResponse;
     import com.aliyun.green20220302.models.DescribeUploadTokenResponseBody;
     import com.aliyun.green20220302.models.FileModerationRequest;
     import com.aliyun.green20220302.models.FileModerationResponse;
     import com.aliyun.green20220302.models.FileModerationResponseBody;
     import com.aliyun.oss.OSS;
     import com.aliyun.oss.OSSClientBuilder;
     import com.aliyun.oss.model.PutObjectRequest;
     import com.aliyun.teaopenapi.models.Config;
     import com.aliyun.teautil.models.RuntimeOptions;
     
     import java.io.File;
     import java.util.HashMap;
     import java.util.Map;
     import java.util.UUID;
     
     public class FileModerationFile {
         /** サービスが VPC にデプロイされているかどうかを指定します。 */
         public static boolean isVPC = false;
     
         /** アップロードトークンをキャッシュします。このマップはエンドポイントをトークンにマッピングします。 */
         public static Map<String, DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData> tokenMap = new HashMap<>();
     
         /** ファイルをアップロードするために使用されるクライアント。 */
         public static OSS ossClient = null;
     
         /**
          * リクエストを送信するためのクライアントを作成します。
          *
          * @param accessKeyId
          * @param accessKeySecret
          * @param endpoint
          * @return
          * @throws Exception
          */
         public static Client createClient(String accessKeyId, String accessKeySecret, String endpoint) throws Exception {
             Config config = new Config();
             config.setAccessKeyId(accessKeyId);
             config.setAccessKeySecret(accessKeySecret);
             // 実際のデプロイメントに基づいてリージョンとエンドポイントを変更します。
             config.setEndpoint(endpoint);
             return new Client(config);
         }
     
         /**
          * ファイルをアップロードするためのクライアントを作成します。
          *
          * @param tokenData
          * @param isVPC
          */
         public static void getOssClient(DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData tokenData, boolean isVPC) {
             // パフォーマンス向上のため、クライアントインスタンスの再利用を推奨します。
             if (isVPC) {
                 ossClient = new OSSClientBuilder().build(tokenData.ossInternalEndPoint, tokenData.getAccessKeyId(), tokenData.getAccessKeySecret(), tokenData.getSecurityToken());
             } else {
                 ossClient = new OSSClientBuilder().build(tokenData.ossInternetEndPoint, tokenData.getAccessKeyId(), tokenData.getAccessKeySecret(), tokenData.getSecurityToken());
             }
         }
     
         /**
          * ファイルをアップロードします。
          *
          * @param filePath
          * @param tokenData
          * @return
          * @throws Exception
          */
         public static String uploadFile(String filePath, DescribeUploadTokenResponseBody.DescribeUploadTokenResponseBodyData tokenData) throws Exception {
             String[] split = filePath.split("\\.");
             String objectName;
             if (split.length > 1) {
                 objectName = tokenData.getFileNamePrefix() + UUID.randomUUID() + "." + split[split.length - 1];
             } else {
                 objectName = tokenData.getFileNamePrefix() + UUID.randomUUID();
             }
             PutObjectRequest putObjectRequest = new PutObjectRequest(tokenData.getBucketName(), objectName, new File(filePath));
             ossClient.putObject(putObjectRequest);
             return objectName;
         }
     
         public static FileModerationResponse invokeFunction(String accessKeyId, String accessKeySecret, String endpoint) throws Exception {
             // パフォーマンス向上のため、クライアントインスタンスの再利用を推奨します。
             Client client = createClient(accessKeyId, accessKeySecret, endpoint);
             RuntimeOptions runtime = new RuntimeOptions();
     
             // ローカルファイルの絶対パス。例：D:\localPath\exampleFile.mp3。
             String filePath = "D:/test/1.pdf";
             // ファイルアップロードトークンを取得します。
             if (tokenMap.get(endpoint) == null || tokenMap.get(endpoint).expiration <= System.currentTimeMillis() / 1000) {
                 DescribeUploadTokenResponse tokenResponse = client.describeUploadToken();
                 tokenMap.put(endpoint, tokenResponse.getBody().getData());
             }
             // ファイルアップロード用のクライアントを作成します。
             getOssClient(tokenMap.get(endpoint), isVPC);
     
             // ファイルをアップロードします。
             String objectName = uploadFile(filePath, tokenMap.get(endpoint));
     
             // モデレーションパラメーターを構築します。
             Map<String, String> serviceParameters = new HashMap<>();
             // ファイルアップロード情報を指定します。
             serviceParameters.put("ossBucketName", tokenMap.get(endpoint).getBucketName());
             serviceParameters.put("ossObjectName", objectName);
             serviceParameters.put("dataId", UUID.randomUUID().toString());
     
             FileModerationRequest request = new FileModerationRequest();
             // モデレーションサービスを指定します。
             request.setService("document_detection_global");
             request.setServiceParameters(JSON.toJSONString(serviceParameters));
     
             FileModerationResponse response = null;
             try {
                 response = client.fileModerationWithOptions(request, runtime);
             } catch (Exception e) {
                 e.printStackTrace();
             }
             return response;
         }
     
         public static void main(String[] args) throws Exception {
             /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する完全な権限が付与されています。セキュリティを強化するため、API 呼び出しや日常的なメンテナンスには RAM ユーザーの使用を推奨します。
              * 環境変数を取得する一般的な方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             String accessKeyId = "YOUR_ACCESS_KEY_ID";
             String accessKeySecret = "YOUR_ACCESS_KEY_SECRET";
             // 実際のデプロイメントに基づいてリージョンとエンドポイントを変更します。
             FileModerationResponse response = invokeFunction(accessKeyId, accessKeySecret, "green-cip.ap-southeast-1.aliyuncs.com");
     
                 // モデレーション結果を出力します。
                 if (response != null) {
                     if (response.getStatusCode() == 200) {
                         FileModerationResponseBody body = response.getBody();
                         System.out.println(JSON.toJSONString(body));
                         System.out.println("requestId = " + body.getRequestId());
                         System.out.println("code = " + body.getCode());
                         System.out.println("msg = " + body.getMessage());
                         Integer code = body.getCode();
                         if (200 == code) {
                             FileModerationResponseBody.FileModerationResponseBodyData data = body.getData();
                             System.out.println("taskId = [" + data.getTaskId() + "]");
                         } else {
                             // ファイルモデレーションが失敗しました。code:
                             System.out.println("File moderation failed. code: " + code);
                         }
                     } else {
                         // リクエストが失敗しました。status:
                         System.out.println("Request failed. status: " + response.getStatusCode());
                     }
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • ファイルモデレーション結果を取得するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する完全な権限が付与されています。セキュリティを強化するため、API 呼び出しや日常的なメンテナンスには RAM ユーザーの使用を推奨します。
              * 環境変数を取得する一般的な方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("YOUR_ACCESS_KEY_ID");
             config.setAccessKeySecret("YOUR_ACCESS_KEY_SECRET");
             // 実際のデプロイメントに基づいてリージョンとエンドポイントを変更します。
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // 読み取りタイムアウト（ミリ秒単位）。
             config.setReadTimeout(6000);
             // 接続タイムアウト（ミリ秒単位）。
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // 送信時に返されたタスクの ID。
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         // ファイルモデレーション結果の取得に失敗しました。code:
                         System.out.println("Failed to retrieve file moderation result. code: " + result.getCode());
                     }
                 } else {
                     // リクエストが失敗しました。status:
                     System.out.println("Request failed. status: " + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

OSS 内のドキュメントのモデレーション

利用シーン

OSS に保存されているドキュメントをモデレーションするには、Content Moderation へのアクセスを許可するサービスロールを作成します。ファイルモデレーション V2.0 サービスは、このロールを使用してドキュメントを取得し、モデレーションを実行します。サービスロールを作成するには、クラウドリソースアクセス認可ページにアクセスしてください。

1. 以下の dependencies を追加します。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>green20220302</artifactId>
     <version>3.3.3</version>
   </dependency>

   OSS SDK をインストールします。

   <dependency>
     <groupId>com.aliyun.oss</groupId>
     <artifactId>aliyun-sdk-oss</artifactId>
     <version>3.16.3</version>
   </dependency>

2. Java SDK を統合します。

   • ファイルモデレーションタスクを送信するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.FileModerationRequest; 
     import com.aliyun.green20220302.models.FileModerationResponse; 
     import com.aliyun.green20220302.models.FileModerationResponseBody; 
     import com.aliyun.teaopenapi.models.Config;
     
     public class FileModerationDemo {
         public static void main(String[] args) throws Exception {
             Config config = new Config();
              /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
              * 環境変数を取得する方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("YOUR_ACCESS_KEY_ID");
             config.setAccessKeySecret("YOUR_ACCESS_KEY_SECRET");
             // デプロイメントに基づいてリージョンとエンドポイントを変更します。
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // 読み取りタイムアウト期間。単位：ミリ秒 (ms)。
             config.setReadTimeout(6000);
             // 接続タイムアウト期間。単位：ミリ秒 (ms)。
             config.setConnectTimeout(3000);
     
             Client client = new Client(config);
             JSONObject serviceParameters = new JSONObject();
             serviceParameters.put("ossBucketName", "your-bucket-name");
             serviceParameters.put("ossObjectName", "path/to/your/document.pdf");
             serviceParameters.put("ossRegionId", "ap-southeast-1"); 
     
             FileModerationRequest fileModerationRequest = new FileModerationRequest(); 
             // モデレーションサービス。一般ドキュメント検出の場合は document_detection_global に設定します。
             fileModerationRequest.setService("document_detection_global");
             fileModerationRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 FileModerationResponse response = client.fileModeration(fileModerationRequest); 
                 if (response.getStatusCode() == 200) {
                     FileModerationResponseBody result = response.getBody(); 
                     System.out.println(JSON.toJSONString(result));
                     System.out.println("requestId = " + result.getRequestId());
                     System.out.println("code = " + result.getCode());
                     System.out.println("msg = " + result.getMessage());
                     Integer code = result.getCode();
                     if (200 == code) {
                         FileModerationResponseBody.FileModerationResponseBodyData data = result.getData();
                         System.out.println("taskId = [" + data.getTaskId() + "]");
                     } else {
                         System.out.println("File moderation failed. code:" + code);
                     }
                 } else {
                     System.out.println("The response was unsuccessful. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
     

   • ファイルモデレーションタスクの結果を取得するサンプルコード

     import com.alibaba.fastjson.JSON;
     import com.alibaba.fastjson.JSONObject;
     import com.aliyun.green20220302.Client;
     import com.aliyun.green20220302.models.DescribeFileModerationResultRequest;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponse;
     import com.aliyun.green20220302.models.DescribeFileModerationResultResponseBody;
     import com.aliyun.teaopenapi.models.Config;
     
     
     public class DescribeFileModerationResultDemo {
     
         public static void main(String[] args) throws Exception {
             Config config = new Config();
             /**
              * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
              * 環境変数を取得する方法：
              * 方法 1：
              *     RAM ユーザーの AccessKey ID を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              * 方法 2：
              *     RAM ユーザーの AccessKey ID を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
              *     RAM ユーザーの AccessKey Secret を取得：System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
              */
             config.setAccessKeyId("YOUR_ACCESS_KEY_ID");
             config.setAccessKeySecret("YOUR_ACCESS_KEY_SECRET");
             // デプロイメントに基づいてリージョンとエンドポイントを変更します。
             config.setRegionId("ap-southeast-1");
             config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
             // 読み取りタイムアウト期間。単位：ミリ秒 (ms)。
             config.setReadTimeout(6000);
             // 接続タイムアウト期間。単位：ミリ秒 (ms)。
             config.setConnectTimeout(3000);
           
             Client client = new Client(config);
     
             JSONObject serviceParameters = new JSONObject();
             // 送信リクエストによって返されたタスク ID。
             serviceParameters.put("taskId", "fi_f_O5z5i*********-1xxp0V");
     
     
             DescribeFileModerationResultRequest describeFileModerationResultRequest = new DescribeFileModerationResultRequest();
             
             describeFileModerationResultRequest.setService("document_detection_global");
             describeFileModerationResultRequest.setServiceParameters(serviceParameters.toJSONString());
     
             try {
                 DescribeFileModerationResultResponse response = client.describeFileModerationResult(describeFileModerationResultRequest);
                 if (response.getStatusCode() == 200) {
                     DescribeFileModerationResultResponseBody result = response.getBody();
                     System.out.println("requestId=" + result.getRequestId());
                     System.out.println("code=" + result.getCode());
                     System.out.println("msg=" + result.getMessage());
                     if (200 == result.getCode()) {
                         DescribeFileModerationResultResponseBody.DescribeFileModerationResultResponseBodyData data = result.getData();
                         System.out.println("pageResult = " + JSON.toJSONString(data.getPageResult()));
                         System.out.println("dataId = " + data.getDataId());
                         System.out.println("url = " + data.getUrl());
                     } else {
                         System.out.println("Failed to retrieve the file moderation result. code:" + result.getCode());
                     }
                 } else {
                     System.out.println("The response was unsuccessful. status:" + response.getStatusCode());
                 }
             } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }

パブリックにアクセス可能なドキュメント

利用シーン

モデレーション対象のドキュメントがパブリック URL でアクセス可能な場合、ファイルモデレーション 2.0 サービスは、そのファイルをフェッチしてモデレーションを実行できます。

1. 次のコマンドを実行して SDK をインストールします。

   pip install alibabacloud_green20220302==3.2.4

2. Python SDK を統合します。

   • ドキュメント検出タスクを送信します

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     import os
     
     config = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000, 
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     serviceParameters = {
         'url': 'https://detect-obj.oss-cn-hangzhou.aliyuncs.com/sample/xxxx.pdf',
     }
     fileModerationRequest = models.FileModerationRequest(
         # 検出サービスのタイプ。
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.file_moderation(fileModerationRequest)
         if response.status_code == 200:
             # API 呼び出しが成功しました。
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

   • ドキュメント検出結果を取得します

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     import os
     
     config = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000, 
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # タスク送信時に返された、クエリ対象のタスク ID。
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # 検出サービスのタイプ。
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # API 呼び出しが成功しました。
             # モデレーション結果を取得します。
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

ローカルドキュメント

利用シーン

モデレーション対象のドキュメントがローカルマシンに保存されており、パブリック URL がない場合、Content Moderation が提供する Object Storage Service (OSS) バケットにアップロードできます。ファイルモデレーション 2.0 サービスは、このバケットにアクセスしてドキュメントをモデレーションします。

1. 次のコマンドを実行して SDK をインストールします。

   pip install alibabacloud_green20220302==3.2.4

   OSS SDK をインストールします。

   pip install oss2

2. Python SDK を統合します。

   • ドキュメント検出タスクを送信します

     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     from alibabacloud_tea_util.client import Client as UtilClient
     from alibabacloud_tea_util import models as util_models
     import json
     import uuid
     import os
     import oss2
     import time
     
     configs = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000,
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=10000,
         # ビジネス要件に基づいてリージョンとエンドポイントを変更します。
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     # 注：パフォーマンスを向上させるため、クライアントインスタンスを再利用して、繰り返し接続を回避してください。
     client = Client(configs)
     
     bucket = None
     upload_token = None
     
     
     def get_oss_client(is_vpc):
         global upload_token
         global bucket
         if (upload_token == None) or int(upload_token.expiration) <= int(time.time()):
             response = client.describe_upload_token()
     
             upload_token = response.body.data
             auth = oss2.StsAuth(upload_token.access_key_id, upload_token.access_key_secret, upload_token.security_token)
     
             end_point = upload_token.oss_internet_end_point
             if (is_vpc):
                 end_point = upload_token.oss_internal_end_point
             bucket = oss2.Bucket(auth, end_point, upload_token.bucket_name)
     
     
     def upload_file(file_name, is_vpc):
         get_oss_client(is_vpc)
         object_name = upload_token.file_name_prefix + str(uuid.uuid4()) + '.' + file_name.split('.')[-1]
         bucket.put_object_from_file(object_name, file_name)
         return object_name
     
     
     def file_moderation_by_local_file(file_path, is_vpc):
         # 1. ファイルをアップロードします。
         object_name = upload_file(file_path, is_vpc)
     
         # 2. 検出パラメーターを設定します。
         service_parameters = {
             'dataId': str(uuid.uuid4()),
             'ossBucketName': upload_token.bucket_name,
             'ossObjectName': object_name
         }
     
         file_moderation_request = models.FileModerationRequest(
             # 検出サービスのタイプ。
             service='document_detection_global',
             service_parameters=json.dumps(service_parameters)
         )
     
         # RuntimeOptions インスタンスを作成し、ランタイムパラメーターを設定します。
         runtime = util_models.RuntimeOptions()
         runtime.read_timeout = 10000
         runtime.connect_timeout = 10000
         try:
             global client
             response = client.file_moderation_with_options(file_moderation_request, runtime)
     
             if response.status_code == 200:
                 # API 呼び出しが成功しました。
                 # モデレーション結果を取得します。
                 result = response.body
                 print('response success. result:{}'.format(result))
                 if result.code == 200:
                     result_data = result.data
                     print('result: {}'.format(result_data))
             else:
                 print('response not success. status:{} ,result:{}'.format(response.status_code, response))
         except Exception as err:
             print(err)
     
     
     if __name__ == '__main__':
         # ローカルファイルのパス。
         file_path = '/Users/test/MS.pdf'
         # サービスが VPC にデプロイされているかどうかを指定します。
         is_vpc = False  # True
         file_moderation_by_local_file(file_path, is_vpc)
          

   • ドキュメント検出結果を取得します

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     import os
     
     config = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000, 
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # タスク送信時に返された、クエリ対象のタスク ID。
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # 検出サービスのタイプ。
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # API 呼び出しが成功しました。
             # モデレーション結果を取得します。
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

OSS ドキュメント

利用シーン

ご利用のドキュメントがすでに Object Storage Service (OSS) にある場合、Content Moderation へのアクセスを許可するためにサービスロールを作成できます。このロールにより、ファイルモデレーション 2.0 サービスは、モデレーションのためにご利用の OSS ファイルを読み取ることができます。クラウドリソースアクセス認可ページにアクセスして、サービスロールを作成してください。

1. 次のコマンドを実行して SDK をインストールします。

   pip install alibabacloud_green20220302==3.2.4

2. Python SDK を統合します。

   • ドキュメント検出タスクを送信します

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     import os
     
     config = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000,
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=3000,
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     serviceParameters = {
         'ossRegionId': 'cn-hangzhou',
         'ossBucketName': 'detect-obj',
         'ossObjectName': 'sample/xxxx.pdf'
     }
     fileModerationRequest = models.FileModerationRequest(
         # 検出サービスのタイプ。
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.file_moderation(fileModerationRequest)
         if response.status_code == 200:
             # API 呼び出しが成功しました。
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)
         

   • ドキュメント検出結果を取得します

     # coding=utf-8
     # python version >= 3.6
     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     import json
     import os
     
     config = Config(
         # 認証には AccessKey ペアが必要です。
         # セキュリティを確保するため、API オペレーションの呼び出しには RAM ユーザーを使用し、AccessKey ペアを環境変数に保存することを推奨します。
         # AccessKey ID または AccessKey Secret をコード内にハードコードしないでください。そうしないと、AccessKey ペアが漏洩する可能性があります。
         # コードを実行する前に、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を設定してください。
         access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
         # 接続タイムアウト。単位：ミリ秒。
         connect_timeout=10000, 
         # 読み取りタイムアウト。単位：ミリ秒。
         read_timeout=3000,  
         region_id='ap-southeast-1',
         endpoint='green-cip.ap-southeast-1.aliyuncs.com'
     )
     
     clt = Client(config)
     
     # タスク送信時に返された、クエリ対象のタスク ID。
     serviceParameters = {
         "taskId": 'fi_f_11w5THcb*******a-1xx7hH'
     }
     describeFileModerationResultRequest = models.DescribeFileModerationResultRequest(
         # 検出サービスのタイプ。
         service='document_detection_global',
         service_parameters=json.dumps(serviceParameters)
     )
     
     try:
         response = clt.describe_file_moderation_result(describeFileModerationResultRequest)
         if response.status_code == 200:
             # API 呼び出しが成功しました。
             # モデレーション結果を取得します。
             result = response.body
             print('response success. result:{}'.format(result))
         else:
             print('response not success. status:{} ,result:{}'.format(response.status_code, response))
     except Exception as err:
         print(err)

パブリックにアクセス可能なドキュメント

ユースケース

モデレーション対象のドキュメントがパブリック URL でアクセス可能な場合、ファイルモデレーション 2.0 サービスはファイルをフェッチしてモデレーションを実行できます。

1. 次のコマンドを実行して依存関係をインストールします。

   composer require alibabacloud/green-20220302 3.2.4

2. PHP SDK を統合します。

   • ドキュメント検出タスクを送信します

     <?php
     require('vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\FileModerationRequest;
     use AlibabaCloud\Tea\Exception\TeaUnableRetryError;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     
     $config = new Config([
         /**
          * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
          * セキュリティを強化するため、コード内に AccessKey ID および AccessKey Secret をハードコードしないでください。
          * このような操作により認証情報が漏洩し、アカウント内のすべてのリソースのセキュリティが脅かされる可能性があります。代わりに、環境変数から認証情報を取得してください。
          * RAM ユーザーの AccessKey ID を取得：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
          * RAM ユーザーの AccessKey Secret を取得：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
          */
         "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
         "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
         "endpoint" => "green-cip.ap-southeast-1.aliyuncs.com",
         "regionId" => "ap-southeast-1"
     
     ]);
     // 注：パフォーマンスを向上させるため、クライアントインスタンスを再利用して繰り返し接続を回避することを推奨します。
     $client = new Green($config);
     
     $request = new FileModerationRequest();
     $request->service = "document_detection_global";
     $serviceParameters = array("url" => "https://xxx.oss.aliyuncs.com/xxx.pdf");
     
     $request->serviceParameters = json_encode($serviceParameters);
     
     $runtime = new RuntimeOptions();
     $runtime->readTimeout = 6000;
     $runtime->connectTimeout = 3000;
     
     try {
         $response = $client->fileModerationWithOptions($request, $runtime);
         print_r($response->body);
         if (200 != $response->statusCode) {
             print_r("Response not successful. Code: " . $response->statusCode);
             return;
         }
         $body = $response->body;
         print_r("requestId = " . $body->requestId . "\n");
         print_r("code = " . $body->code . "\n");
         print_r("message = " . $body->message . "\n");
         if (200 != $body->code) {
             print_r("File moderation not successful. Code: " . $body->code);
         }
         $data = $body->data;
         print_r("taskId = " . $data->taskId);
     } catch (TeaUnableRetryError $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

   • ドキュメント検出タスクの結果を取得します

     <?php
     require('vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\DescribeFileModerationResultRequest;
     use AlibabaCloud\Tea\Exception\TeaUnableRetryError;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     
     $config = new Config([
         /**
          * Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な O&M には RAM ユーザーの使用を推奨します。
          * セキュリティを強化するため、コード内に AccessKey ID および AccessKey Secret をハードコードしないでください。
          * このような操作により認証情報が漏洩し、アカウント内のすべてのリソースのセキュリティが脅かされる可能性があります。代わりに、環境変数から認証情報を取得してください。
          * RAM ユーザーの AccessKey ID を取得：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
          * RAM ユーザーの AccessKey Secret を取得：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
          */
         "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
         "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
         "endpoint" => "green-cip.ap-southeast-1.aliyuncs.com",
         "regionId" => "ap-southeast-1"
     
     ]);
     // 注：パフォーマンスを向上させるため、クライアントインスタンスを再利用して繰り返し接続を回避することを推奨します。
     $client = new Green($config);
     
     $request = new DescribeFileModerationResultRequest();
     $request->service = "document_detection_global";
     $serviceParameters = array("taskId" => "fi_f_O5z5iaIis*****NYj7qa-1x****");
     
     $request->serviceParameters = json_encode($serviceParameters);
     
     $runtime = new RuntimeOptions();
     $runtime->readTimeout = 6000;
     $runtime->connectTimeout = 3000;
     
     try {
         $response = $client->describeFileModerationResultWithOptions($request, $runtime);
         if (200 != $response->statusCode) {
             print_r("Response not successful. Code: " . $response->statusCode);
             return;
         }
         $body = $response->body;
         print_r("requestId = " . $body->requestId . "\n");
         print_r("code = " . $body->code . "\n");
         print_r("message = " . $body->message . "\n");
         if (280 == $body->code) {
             print_r("Processing file moderation. Code: " . $body->code);
             return;
         }
         if (200 != $body->code) {
             print_r("File moderation result not successful. Code: " . $body->code);
             return;
         }
         $data = $body->data;
           print_r("data = " . json_encode($data) . "\n");
         print_r("pageResult = " . json_encode($data->pageResult) . "\n");
     } catch (TeaUnableRetryError $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

ローカルドキュメント

ユースケース

パブリックにアクセスできないローカルドキュメントをモデレーションするには、Content Moderation が提供する OSS バケットにアップロードします。ファイルモデレーション 2.0 サービスは、このバケットからファイルにアクセスしてモデレーションを実行します。

1. 次のコマンドを実行して依存関係をインストールします。

   composer require alibabacloud/green-20220302 3.2.4

   OSS SDK をインストールします。

   composer require aliyuncs/oss-sdk-php

2. PHP SDK を統合します。

   • ドキュメント検出タスクを送信します

   • ドキュメント検出タスクの結果を取得します

OSS ドキュメント

ユースケース

モデレーション対象のドキュメントがすでに OSS に保存されている場合、Content Moderation が直接アクセスできるようにサービスロールを作成できます。このサービスロールにより、Content Moderation サービスにご利用の OSS ファイルへの読み取りアクセス権限が付与されます。ファイルモデレーション 2.0 サービスは、このロールを使用してドキュメントをフェッチしてモデレーションを実行します。サービスロールを作成するには、クラウドリソースアクセス認可ページにアクセスしてください。

1. 次のコマンドを実行して依存関係をインストールします。

   composer require alibabacloud/green-20220302 3.2.4

2. PHP SDK を統合します。

   • ドキュメント検出タスクを送信します

   • ドキュメント検出タスクの結果を取得します

パブリックにアクセス可能なドキュメント

ユースケース

ご利用のドキュメントがパブリック URL でアクセス可能な場合、ドキュメント検出 version 2.0 サービスはファイルをフェッチしてモデレーションを実行できます。

ローカルドキュメント

ユースケース

パブリックにアクセスできないローカルドキュメントをモデレーションするには、Content Moderation が提供する Object Storage Service (OSS) バケットにアップロードします。ドキュメント検出 version 2.0 サービスは、この OSS バケットからドキュメントにアクセスしてモデレーションを実行できます。

1. 次のコマンドを実行して必要な依存関係をインストールします。

   go get github.com/alibabacloud-go/green-20220302/v3@v3.2.4

   OSS SDK をインストールします。

   go get github.com/aliyun/aliyun-oss-go-sdk/oss

2. Go SDK を統合します。

   • ドキュメント検出タスクを送信するサンプルコード

   • ドキュメント検出タスクの結果を取得します

OSS ドキュメント

ユースケース

Object Storage Service (OSS) に保存されているドキュメントをモデレーションするには、まずサービスロールを作成して Content Moderation にご利用の OSS リソースへのアクセスを許可する必要があります。ドキュメント検出 version 2.0 サービスは、このロールを使用してドキュメントをフェッチしてモデレーションを実行します。サービスロールを作成するには、クラウドリソースアクセス認可ページにアクセスしてください。

1. 次のコマンドを実行して依存関係をインストールします。

   go get github.com/alibabacloud-go/green-20220302/v3@v3.2.4

2. Go SDK を統合します。

   • ドキュメント検出タスクを送信するサンプルコード

   • ドキュメント検出タスクの結果を取得します

パブリック URL ドキュメント

利用シーン

ドキュメントがパブリック URL でアクセス可能な場合、ドキュメントモデレーション 2.0 サービスは URL からファイルをフェッチしてモデレーションを実行できます。

1. 次のコマンドを実行して必要な依存関係をインストールします。

   npm install @alicloud/green20220302@3.2.4

2. Node.js SDK を統合します。

   • ドキュメントモデレーションタスクを送信するサンプルコード

     ドキュメントモデレーションタスクの結果を取得するサンプルコード

ローカルファイル

利用シーン

ドキュメントがローカルに保存されており、パブリック URL がない場合、Content Moderation が提供する Object Storage Service (OSS) バケットにアップロードできます。ドキュメントモデレーション 2.0 サービスは、OSS からファイルを取得してモデレーションを実行します。

1. 次のコマンドを実行して必要な依存関係をインストールします。

   npm install @alicloud/green20220302@3.2.4

   OSS SDK をインストールします。

   npm install ali-oss --save

2. Node.js SDK を統合します。

   • ドキュメントモデレーションタスクを送信するサンプルコード

     ドキュメントモデレーションタスクの結果を取得するサンプルコード

OSS ドキュメント

利用シーン

モデレーション対象のドキュメントがすでに Object Storage Service (OSS) にある場合、Content Moderation がご利用の OSS リソースにアクセスできるようにサービスロールを作成する必要があります。ドキュメントモデレーション 2.0 サービスは、このロールを使用してファイルをフェッチしてモデレーションを実行します。サービスロールはクラウドリソースアクセス認可ページで作成できます。

1. 次のコマンドを実行して必要な依存関係をインストールします。

   npm install @alicloud/green20220302@3.2.4

2. Node.js SDK を統合します。

   • ドキュメントモデレーションタスクを送信するサンプルコード

     ドキュメントモデレーションタスクの結果を取得するサンプルコード

パブリック URL からのドキュメント検出

ユースケース

モデレーション対象のドキュメントがパブリック URL でアクセス可能な場合、ドキュメント検出 2.0 サービスは URL からファイルをフェッチしてモデレーションを実行できます。

1. 次のコマンドを実行して必要な依存関係をインストールします。

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 3.2.4

2. C# SDK を統合します。

   • ドキュメント検出タスクを送信するサンプルコード

   • ドキュメント検出タスクの結果を取得するサンプルコード

ローカルドキュメントの検出

ユースケース

パブリック URL でアクセスできないローカルに保存されているドキュメントをモデレーションする必要がある場合、Content Moderation が提供する Object Storage Service (OSS) バケットにアップロードできます。ドキュメントモデレーションサービスは、OSS からファイルに直接アクセスしてモデレーションを実行できます。

1. 次のコマンドを実行して依存関係を追加します。

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 3.2.4

   OSS SDK をインストールします。

   NuGet 経由でインストール 
   1. Visual Studio に NuGet がインストールされていない場合は、まずインストールしてください。
   2. Visual Studio でプロジェクトを作成または開きます。[ツール] > [NuGet パッケージマネージャー] > [ソリューションの NuGet パッケージの管理] を選択します。
   3. aliyun.oss.sdk を検索します。結果から Aliyun.OSS.SDK (.NET Framework 向け) または Aliyun.OSS.SDK.NetCore (.NET Core 向け) を見つけ、最新バージョンを選択して [インストール] をクリックします。

2. C# SDK を統合します。

   • ドキュメント検出タスクを送信します

   • ドキュメント検出タスクの結果を取得します

OSS 内のドキュメントのモデレーション

利用シーン

モデレーション対象のドキュメントファイルがすでに Alibaba Cloud Object Storage Service (OSS) に保存されている場合、Content Moderation サービスが OSS にアクセスできるようにサービスロールの作成と認証付与を行うことができます。Document Moderation version 2.0 サービスは、このサービスロールを使用して OSS からファイルを取得し、モデレーションを実行します。クラウドリソースアクセス認可ページにアクセスして、サービスロールを作成してください。

1. 次のコマンドを実行して必要な依存関係を追加します。

   dotnet add package AlibabaCloud.SDK.Green20220302 --version 3.2.4

2. C# SDK を統合します。

   • ドキュメントモデレーションタスクを送信するサンプルコード

   • ドキュメントモデレーション結果を取得するサンプルコード