Content Moderation：SDK layanan umum moderasi teks versi tingkat lanjut dan panduan integrasi

Java SDK

Didukung Java 1.8 atau yang lebih baru.

Untuk kode sumber, lihat kode sumber Java SDK atau kode sumber Java SDK (jalur OSS).

Tambahkan dependensi berikut ke file pom.xml untuk menggunakan SDK dalam proyek Maven Anda.

1. Tambahkan dependensi berikut ke bagian dependencies:

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

2. Integrasikan Java SDK.

   Kode contoh

   import com.alibaba.fastjson.JSON;
   import com.alibaba.fastjson.JSONObject;
   import com.aliyun.green20220302.Client;
   import com.aliyun.green20220302.models.TextModerationRequest;
   import com.aliyun.green20220302.models.TextModerationResponse;
   import com.aliyun.green20220302.models.TextModerationResponseBody;
   import com.aliyun.teaopenapi.models.Config;
   import com.aliyun.teautil.models.RuntimeOptions;
   
   public class TextAutoRoute {
       public static void main(String[] args) throws Exception {
           Config config = new Config();
           // Kebocoran kode sumber Anda dapat menyebabkan kebocoran Pasangan AccessKey Anda dan mengancam keamanan semua sumber daya Anda. Kode contoh berikut hanya untuk referensi. Gunakan token Security Token Service (STS) untuk otorisasi. Untuk informasi selengkapnya, lihat dokumentasi terkait.
           // Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
           config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
           config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
           // Ubah wilayah dan titik akhir sesuai kebutuhan.
           config.setRegionId("ap-southeast-1");
           config.setEndpoint("green-cip.ap-southeast-1.aliyuncs.com");
           // Atur periode waktu tunggu baca dan koneksi dalam milidetik.
           config.setReadTimeout(6000);
           config.setConnectTimeout(3000);
   
           // Untuk meningkatkan kinerja, gunakan kembali instance klien untuk menghindari pembuatan banyak koneksi.
           Client client = new Client(config);
   
           // Buat instance RuntimeObject dan atur parameter runtime.
           RuntimeOptions runtime = new RuntimeOptions();
           runtime.readTimeout = 10000;
           runtime.connectTimeout = 10000;
   
           // Bangun parameter layanan.
           JSONObject serviceParameters = new JSONObject();
           serviceParameters.put("content", "teks yang akan dideteksi");
   
           if (serviceParameters.get("content") == null || serviceParameters.getString("content").trim().length() == 0) {
               System.out.println("konten moderasi teks kosong");
               return;
           }
   
           TextModerationRequest textModerationRequest = new TextModerationRequest();
           // Atur layanan sesuai kebutuhan.
           textModerationRequest.setService("layanan moderasi teks");
           textModerationRequest.setServiceParameters(serviceParameters.toJSONString());
           try {
               // Dapatkan hasil deteksi.
               TextModerationResponse response = client.textModerationWithOptions(textModerationRequest, runtime);
   
               // Cetak hasil deteksi.
               if (response != null) {
                   if (response.getStatusCode() == 200) {
                       TextModerationResponseBody result = response.getBody();
                       System.out.println(JSON.toJSONString(result));
                       Integer code = result.getCode();
                       if (code != null && code == 200) {
                       TextModerationResponseBody.TextModerationResponseBodyData data = result.getData();
                       System.out.println("label = [" + data.getLabels() + "]");
                       System.out.println("alasan = [" + data.getReason() + "]");
                   } else {
                       System.out.println("moderasi teks tidak berhasil. kode:" + code);
                   }
                   } else {
                       System.out.println("respons tidak berhasil. status:" + response.getStatusCode());
                   }
                   }
                   } catch (Exception e) {
                       e.printStackTrace();
                   }
           }
   }

Python SDK

Didukung Python 3.6 atau yang lebih baru.

Untuk kode sumber, lihat kode sumber Python SDK.

Didukung oleh Python 3.6 atau versi yang lebih baru.

1. Jalankan perintah berikut untuk menginstal dependensi:

   pip install alibabacloud_green20220302==2.2.11

2. Integrasikan Python SDK.

   Contoh

   # coding=utf-8
   
   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
   
   
   class TextAutoRoute:
   
       @staticmethod
       def main() -> None:
           service_parameters = {
               'content': 'teks yang akan dideteksi',
               'dataId': str(uuid.uuid1())
           }
           if service_parameters.get("content") is None or len(service_parameters.get("content").strip()) == 0:
               print("konten moderasi teks kosong")
               return
           text_moderation_request = models.TextModerationRequest(
               # Atur layanan sesuai kebutuhan.
               service = 'layanan moderasi teks',
               service_parameters = json.dumps(service_parameters)
           )
           # Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
           config = Config(
               # Kebocoran kode sumber Anda dapat menyebabkan kebocoran Pasangan AccessKey Anda dan mengancam keamanan semua sumber daya Anda. Kode contoh berikut hanya untuk referensi. Gunakan token STS untuk otorisasi. Untuk informasi selengkapnya, lihat dokumentasi terkait.
               access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
               access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
               # Atur periode waktu tunggu baca dan koneksi dalam milidetik.
               connect_timeout=3000,
               read_timeout=6000,
               # Ubah wilayah dan titik akhir sesuai kebutuhan.
               region_id='ap-southeast-1',
               endpoint='green-cip.ap-southeast-1.aliyuncs.com'
           )
           # Untuk meningkatkan kinerja, gunakan kembali instance klien untuk menghindari pembuatan banyak koneksi.
           client = Client(config)
   
           # Buat instance RuntimeObject dan atur parameter runtime.
           runtime = util_models.RuntimeOptions()
           runtime.read_timeout = 10000
           runtime.connect_timeout = 10000
           try:
               response = client.text_moderation_with_options(text_moderation_request, runtime)
   
               if response.status_code == 200:
                   # Cetak hasil deteksi.
                   result = response.body
                   print('respons berhasil. hasil:{}'.format(result))
                   if result.code == 200:
                       resultData = result.data
                       print('label:{}, alasan:{}'.format(resultData.labels, resultData.reason))
               else:
                   print('respons tidak berhasil. status:{} ,hasil:{}'.format(response.status_code, response))
           except Exception as err:
               print(err)
   
   
   if __name__ == '__main__':
       TextAutoRoute.main()

PHP SDK

SDK mendukung PHP 5.6 atau yang lebih baru.

Untuk kode sumber, lihat kode sumber PHP SDK.

1. Jalankan perintah berikut untuk mengimpor dependensi:

   composer require alibabacloud/green-20220302 2.2.10

2. Integrasikan PHP SDK.

   Kode contoh

   <?php
   
     require('vendor/autoload.php');
   
   use AlibabaCloud\Tea\Utils\Utils;
   use Darabonba\OpenApi\Models\Config;
   use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
   use AlibabaCloud\SDK\Green\V20220302\Green;
   use AlibabaCloud\SDK\Green\V20220302\Models\TextModerationRequest;
   
   
   $request = new TextModerationRequest();
   // Atur layanan sesuai kebutuhan.
   $request->service = "layanan moderasi teks";
   $arr = array('content' => 'teks yang akan dideteksi');
   $request->serviceParameters = json_encode($arr);
   if (empty($arr) || empty(trim($arr["content"]))) {
     echo "konten moderasi teks kosong";
     return;
   }
   $config = new Config([
                        // Kebocoran kode sumber Anda dapat menyebabkan kebocoran Pasangan AccessKey Anda dan mengancam keamanan semua sumber daya Anda. Kode contoh berikut hanya untuk referensi. Gunakan token STS untuk otorisasi. Untuk informasi selengkapnya, lihat dokumentasi terkait.
                        // Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
                        "accessKeyId" => getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
                        "accessKeySecret" => getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
                        // Ubah wilayah dan titik akhir sesuai kebutuhan.
                        "endpoint" => "green-cip.ap-southeast-1.aliyuncs.com",
                        "regionId" => "ap-southeast-1"
   
                        ]);
   // Untuk meningkatkan kinerja, gunakan kembali instance klien untuk menghindari pembuatan banyak koneksi.
   $client = new Green($config);
   
   // Buat instance RuntimeObject dan atur parameter runtime.
   $runtime = new RuntimeOptions([]);
   $runtime->readTimeout = 10000;
   $runtime->connectTimeout = 10000;
   
   try {
     // Dapatkan hasil deteksi.
     $response = $client->textModerationWithOptions($request, $runtime);
     // Cetak hasil deteksi.
     print_r($response->body);
   } catch (Exception $e) {
     var_dump($e->getMessage());
     var_dump($e->getErrorInfo());
     var_dump($e->getLastException());
     var_dump($e->getLastRequest());
   }

Go SDK

1. Jalankan perintah berikut untuk mengimpor dependensi:

   go git clone --branch v2.2.11 github.com/alibabacloud-go/green-20220302/v2

2. Integrasikan Go SDK.

   Kode contoh

   package main
   
   import (
   	"encoding/json"
   	"fmt"
   	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
   	green "github.com/alibabacloud-go/green-20220302/v2/client"
   	"github.com/alibabacloud-go/tea/tea"
   	"net/http"
   )
   
   func main() {
   	config := &openapi.Config{
   		// ID AccessKey Anda.
   		AccessKeyId: tea.String("Dapatkan ID AccessKey Pengguna RAM dari variabel lingkungan"),
   		// Rahasia AccessKey Anda.
   		AccessKeySecret: tea.String("Dapatkan Rahasia AccessKey Pengguna RAM dari variabel lingkungan"),
   		// Titik akhir yang akan diakses.
   		Endpoint: tea.String("green-cip.ap-southeast-1.aliyuncs.com"),
   		/**
   		 * Atur periode waktu tunggu. Periode waktu tunggu end-to-end di sisi server adalah 10 detik. Konfigurasikan periode waktu tunggu sesuai kebutuhan.
   		 * Jika Anda mengatur parameter ReadTimeout ke nilai yang kurang dari waktu yang dibutuhkan untuk pemrosesan di sisi server, program Anda akan menerima pengecualian ReadTimeout.
   		 */
   		ConnectTimeout: tea.Int(3000),
   		ReadTimeout:    tea.Int(6000),
   	}
   	client, _err := green.NewClient(config)
   	if _err != nil {
   		panic(_err)
   	}
   
   	serviceParameters, _ := json.Marshal(
   		map[string]interface{}{
   			"content": "teks yang akan dimoderasi",
   		},
   	)
   	request := green.TextModerationRequest{
   		Service:           tea.String("layanan moderasi teks"),
   		ServiceParameters: tea.String(string(serviceParameters)),
   	}
   	result, _err := client.TextModeration(&request)
   	if _err != nil {
   		panic(_err)
   	}
   	statusCode := tea.IntValue(tea.ToInt(result.StatusCode))
   	if statusCode == http.StatusOK {
   		textModerationResponse := result.Body
   		fmt.Println("respons berhasil. respons:" + textModerationResponse.String())
   		if tea.IntValue(tea.ToInt(textModerationResponse.Code)) == 200 {
   			textModerationResponseData := textModerationResponse.Data
   			fmt.Println("alasan respons:" + tea.StringValue(textModerationResponseData.Reason))
   			fmt.Println("label respons:" + tea.StringValue(textModerationResponseData.Labels))
   		}
   	} else {
   		fmt.Println("respons tidak berhasil. status:" + tea.ToString(statusCode))
   	}
   }

Node.js SDK

1. Jalankan perintah berikut untuk menginstal dependensi:

   npm install @alicloud/green20220302@2.2.10

2. Integrasikan Node.js SDK.

   Kode contoh

   const RPCClient = require("@alicloud/pop-core");
   
   async function main() {
       // Untuk meningkatkan kinerja, gunakan kembali instance klien untuk menghindari pembuatan banyak koneksi.
       var client = new RPCClient({
           // Kebocoran kode sumber Anda dapat menyebabkan kebocoran Pasangan AccessKey Anda dan mengancam keamanan semua sumber daya Anda. Kode contoh berikut hanya untuk referensi. Gunakan token STS untuk otorisasi. Untuk informasi selengkapnya, lihat dokumentasi terkait.
           // Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
           accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
           // Ubah wilayah dan titik akhir sesuai kebutuhan.
           endpoint: "https://green-cip.ap-southeast-1.aliyuncs.com",
           apiVersion: '2022-03-02'
       });
       // Buat instance RuntimeObject dan atur parameter runtime.
       var params = {
           // Atur layanan sesuai kebutuhan.
           "Service": "layanan moderasi teks",
           "ServiceParameters": JSON.stringify({
               "content": "teks yang akan dideteksi",
           })
       }
   
    		var serviceParameters = JSON.parse(params.ServiceParameters);
       if (!serviceParameters.hasOwnProperty("content") || serviceParameters.content.trim().length === 0) {
           console.log("konten moderasi teks kosong")
           return;
       }
   
       var requestOption = {
           method: 'POST',
           formatParams: false,
       };
   
       try {
           // Dapatkan hasil deteksi.
           var response = await client.request('TextModeration', params, requestOption)
           // Cetak hasil deteksi.
           console.log(JSON.stringify(response))
       } catch (err) {
           console.log(err);
      }
   }
   
   main().then(function (response) { });

C# SDK

1. Jalankan perintah berikut untuk mengimpor dependensi:

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

2. Integrasikan C# SDK.

   Kode contoh

   // File ini dibuat secara otomatis, jangan mengeditnya. Terima kasih.
   
   using Newtonsoft.Json;
   
   namespace AlibabaCloud.SDK.Green20220302
   {
       public class TextModerationAutoRoute
       {
           public static void Main(string[] args)
           {
               // Bangun permintaan moderasi teks.
               AlibabaCloud.SDK.Green20220302.Models.TextModerationRequest textModerationRequest = new AlibabaCloud.SDK.Green20220302.Models.TextModerationRequest();
               // Atur layanan sesuai kebutuhan.
               textModerationRequest.Service = "layanan moderasi teks";
               Dictionary<string, object> task = new Dictionary<string, object>();
               task.Add("content", "teks yang akan dideteksi");
               if (!task.ContainsKey("content") || Convert.ToString(task["content"]).Trim() == string.Empty)
               {
                   Console.WriteLine("konten moderasi teks kosong");
                   return;
               }
               textModerationRequest.ServiceParameters = JsonConvert.SerializeObject(task);
   
   
               // Kebocoran kode sumber Anda dapat menyebabkan kebocoran Pasangan AccessKey Anda dan mengancam keamanan semua sumber daya Anda. Kode contoh berikut hanya untuk referensi. Gunakan token STS untuk otorisasi. Untuk informasi selengkapnya, lihat dokumentasi terkait.
               // Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
               AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
               {
                   AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                   AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                   // Ubah wilayah dan titik akhir sesuai kebutuhan.
                   Endpoint = "green-cip.ap-southeast-1.aliyuncs.com",
               };
               // Untuk meningkatkan kinerja, gunakan kembali instance klien untuk menghindari pembuatan banyak koneksi.
               AlibabaCloud.SDK.Green20220302.Client client = new AlibabaCloud.SDK.Green20220302.Client(config);
   
               // Buat instance RuntimeObject dan atur parameter runtime.
               AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
               runtime.ReadTimeout = 10000;
               runtime.ConnectTimeout = 10000;
               try
               {
                   // Dapatkan hasil deteksi.
                   AlibabaCloud.SDK.Green20220302.Models.TextModerationResponse response =
                   client.TextModerationWithOptions(textModerationRequest, runtime);
   
                   // Cetak hasil deteksi.
                   Console.WriteLine(response.Body.RequestId);
                   Console.WriteLine(JsonConvert.SerializeObject(response.Body));
               }
               catch (Exception _err)
               {
                   Console.WriteLine(_err);
               }
           }
       }
   }