Layanan multi-bahasa yang disediakan oleh Text Moderation 2.0 - Content Moderation

Text Moderation 2.0 meningkatkan kemampuan model multi-bahasa, mendukung lebih banyak bahasa, dan dapat mengidentifikasi bahasa secara otomatis. Dengan mempertimbangkan karakteristik bisnis global, Text Moderation 2.0 menggunakan kebijakan moderasi terpisah serta sistem pelabelan internasionalisasi terpisah. Topik ini menjelaskan layanan multi-bahasa yang disediakan oleh Text Moderation 2.0 dan cara menggunakannya.

Pengenalan fitur

Dibandingkan dengan versi sebelumnya, Text Moderation 2.0 menggunakan kebijakan moderasi terpisah dan sistem pelabelan internasionalisasi terpisah untuk memenuhi persyaratan bisnis global. Selain itu, menyediakan lebih banyak fitur untuk menyederhanakan penggunaan layanan dan membantu dalam tinjauan manual.

Item Perbandingan	Text Moderation 2.0	Text Moderation 1.0
Kemampuan Multi-Bahasa	Mendukung 38 bahasa.	Mendukung 18 bahasa.
Kemampuan Moderasi	Menggunakan beberapa model dan memasukkan karakteristik bahasa serta regional. Kebijakan moderasi lebih akurat.	Menggunakan model tunggal dan memasukkan karakteristik bahasa. Kebijakan moderasi mempertimbangkan akurasi dan recall.
Sistem Pelabelan	Menggunakan sistem pelabelan internasionalisasi terpisah untuk bisnis global, menambahkan label internasionalisasi seperti kata-kata kasar dan wilayah, serta mendukung beberapa label risiko dan subkategori label.	Mewarisi sistem pelabelan dari versi sebelumnya dan hanya mendukung satu label risiko tunggal untuk tugas moderasi teks.
Operasi	Tidak perlu menentukan bahasa input, karena Text Moderation 2.0 dapat mengidentifikasi secara otomatis. Setelah moderasi selesai, jenis bahasa dan konten terjemahan dalam bahasa Inggris dikembalikan untuk membantu tinjauan manual.	Perlu menentukan bahasa input. Tidak ada terjemahan yang dikembalikan.

Bahasa yang didukung

Layanan multi-bahasa dari Text Moderation 2.0 mendukung 38 bahasa.

Jenis bahasa	Nama	Kode bahasa
Inggris	Inggris	en
Cina Sederhana	Cina	zh
Cina Tradisional	Cina Tradisional	zh-tw
Indonesian	Indonesian	id
Melayu	Melayu	ms
Thai	Thai	th
Bahasa Vietnam	Bahasa Vietnam	vi
Tagalog	Tagalog	tl
Hindi	Hindi	hi
Arab	Arab	ar
Turki	Turki	tr
Prancis	Prancis	fr
Jerman	Jerman	de
Rusia	Rusia	ru
Portugis	Portugis	pt
Spanyol	Spanyol	es
Italia	Italia	it
Belanda	Belanda	nl
Polandia	Polandia	pl
Jepang	Jepang	ja
Korea	Korea	ko
Urdu	Urdu	ur
Uighur	Uighur	ug
Bengali	Bengali	bn
Persia	Persia	fa
Swedia	Swedia	sv
Bahasa Denmark	Bahasa Denmark	da
Norwegia	Norwegia	no
Islandia	Islandia	is
Finlandia	Finlandia	fi
Belarusia	Belarusia	be
Lituania	Lituania	lt
Ceko	Ceko	cs
Bahasa Slovakia	Bahasa Slovakia	sk
Hongaria	Hongaria	hu
Yunani	Yunani Modern	el
Rumania	Rumania	ro
Bahasa Irlandia	Bahasa Irlandia	ga

Label internasionalisasi

Layanan multi-bahasa dari Text Moderation 2.0 mengadopsi sistem pelabelan internasionalisasi. Jika konten berisi beberapa jenis risiko, beberapa label dapat dikembalikan pada saat yang sama. Kategori label termasuk, namun tidak terbatas pada, yang tercantum dalam tabel berikut.

Jenis label	Kategori
Label tingkat-1	violence: kekerasan contraband: barang selundupan sexuality: pornografi profanity: kata-kata kasar dan pelecehan pullinTraffic: konten iklan regional: permusuhan regional C_customized: pustaka kustom yang terkena dampak
Label subkategori (riskTips)	Label subkategori dikembalikan dalam format `xxx_yyy`. Contoh: `contraband_Drugs`.

Metode penagihan

Text Moderation 2.0 mendukung metode penagihan bayar sesuai pemakaian.

Bayar sesuai pemakaian

Setelah mengaktifkan layanan Text Moderation 2.0, metode penagihan default adalah bayar sesuai pemakaian. Biaya harian dihitung berdasarkan penggunaan aktual. Jika layanan tidak dipanggil, tidak ada biaya yang dikenakan.

Jenis moderasi	Skenario bisnis yang didukung (layanan)	Harga satuan
Moderasi teks tingkat lanjut (text_advanced)	Moderasi multi-bahasa dalam skenario bisnis internasional: comment_multilingual_global	USD 0,3 per seribu panggilan

Menggunakan layanan Text Moderation 2.0

Langkah 1: Aktifkan Text Moderation 2.0

Buka halaman Aktivasi Layanan untuk mengaktifkan layanan Text Moderation 2.0.

Setelah mengaktifkan layanan Text Moderation 2.0, metode penagihan default adalah bayar sesuai pemakaian. Biaya harian diselesaikan berdasarkan penggunaan aktual. Jika layanan tidak dipanggil, tidak ada biaya yang dikenakan. Setelah memanggil operasi API, sistem penagihan secara otomatis menagih Anda berdasarkan penggunaan Anda. Untuk informasi lebih lanjut, lihat Aturan penagihan.

Langkah 2: Berikan izin kepada pengguna RAM

Sebelum memanggil operasi API atau menggunakan SDK sebagai Pengguna Resource Access Management (RAM), Anda harus memberikan izin kepada pengguna RAM. Anda dapat membuat pasangan AccessKey untuk akun Alibaba Cloud Anda dan pengguna RAM. Saat memanggil operasi API, Anda harus menggunakan pasangan AccessKey untuk menyelesaikan verifikasi identitas. Untuk informasi tentang cara mendapatkan pasangan AccessKey, lihat Mendapatkan pasangan AccessKey.

Masuk ke Konsol RAM sebagai administrator RAM.
Buat pengguna RAM.

Untuk informasi lebih lanjut, lihat Buat pengguna RAM.
Berikan kebijakan sistem AliyunYundunGreenWebFullAccess kepada pengguna RAM.

Untuk informasi lebih lanjut, lihat Berikan izin kepada pengguna RAM.

Setelah menyelesaikan operasi sebelumnya, Anda dapat memanggil API Content Moderation sebagai pengguna RAM.

Langkah 3: Instal dan gunakan SDK

Tabel berikut mencantumkan wilayah yang didukung. Untuk informasi lebih lanjut tentang operasi API, lihat Layanan Text Moderation 2.0 di SDK Text Moderation 2.0 dan panduan penggunaan.

Wilayah	Titik akhir publik	Titik akhir internal
Singapura	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com
AS (Virginia)	green-cip.us-east-1.aliyuncs.com	green-cip-vpc.us-east-1.aliyuncs.com
AS (Silicon Valley)	green-cip.us-west-1.aliyuncs.com	Tidak tersedia
Inggris (London)	green-cip.eu-west-1.aliyuncs.com	Tidak tersedia

Catatan

Jika Anda memerlukan kode contoh SDK dalam bahasa pemrograman lain, Anda dapat memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan kode contoh operasi untuk berbagai SDK.

API

Catatan penggunaan

Titik akhir layanan: https://green-cip.{region}.aliyuncs.com.

Anda dapat memanggil operasi TextModeration untuk membuat tugas moderasi teks. Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Sintaks Permintaan. Anda juga dapat memilih permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Gunakan layanan Text Moderation 2.0.

Metode Penagihan
Anda akan dikenakan biaya untuk memanggil operasi ini. Anda hanya akan dikenakan biaya menggunakan metode penagihan bayar sesuai pemakaian untuk permintaan yang kode status HTTP-nya adalah 200. Untuk informasi lebih lanjut tentang metode penagihan, lihat Metode Penagihan.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, throttling akan dipicu. Akibatnya, bisnis Anda mungkin terpengaruh. Kami sarankan Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter permintaan

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
Service	String	Ya	comment_multilingual_global	Jenis layanan moderasi. Nilai valid: comment_multilingual_global: Moderasi multi-bahasa dalam skenario bisnis internasional.
ServiceParameters	JSONString	Ya		Parameter yang diperlukan oleh layanan moderasi. Nilainya adalah string JSON. Untuk informasi lebih lanjut tentang deskripsi setiap string, lihat ServiceParameters.

Tabel 1 ServiceParameters

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
content	String	Ya	Konten yang akan dimoderasi	Teks yang akan dimoderasi, yang panjangnya harus dalam 600 karakter.
accountId	String	Tidak	10123****	ID akun, yang secara unik mengidentifikasi sebuah akun.
deviceId	String	Tidak	20240307****	ID perangkat, yang secara unik mengidentifikasi sebuah perangkat.
deviceToken	String	Tidak	MzQvo1d7scyZ3tl_RcJ******	Token perangkat yang diperoleh menggunakan SDK kontrol risiko.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Code	Integer	200	Kode status HTTP yang dikembalikan. Untuk informasi lebih lanjut, lihat Kode kesalahan.
Data	JSONObject		Hasil moderasi. Untuk informasi lebih lanjut, lihat Data.
Message	String	OK	Pesan yang dikembalikan sebagai respons terhadap permintaan.
RequestId	String	AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****	ID permintaan.

Tabel 2 Data

Parameter	Tipe	Contoh	Deskripsi
Labels	String	sexual_content	Label. Beberapa label dipisahkan oleh koma (,). Nilai valid: violence: kekerasan contraband: barang selundupan sexuality: Pornografi profanity: kata-kata kasar dan pelecehan pullinTraffic: konten iklan regional: permusuhan regional C_customized: pustaka kustom yang terkena dampak
Reason	String	{"customizedWords": "HXXXXX","detectedLanguage": "en","riskTips": "sexuality_Suggestive","riskWords": "pxxxxy","translatedContent": "pxxxxy sxxxx,HXXXXX","customizedLibs": "ZXXXXX"}	String JSON yang digunakan untuk menentukan penyebab. Nilai valid: riskLevel: tingkat risiko, yang dikembalikan berdasarkan tingkat risiko yang direkomendasikan oleh sistem. Nilai valid: high medium low Catatan Saran penanganan berikut direkomendasikan: Pelanggan menangani konten berisiko tinggi langsung. Tinjauan manual harus dilakukan pada konten berisiko sedang. Konten berisiko rendah dapat ditangani ketika konten lebih berisiko terdeteksi. Pelanggan dapat menangani konten yang tidak terdeteksi risikonya berdasarkan persyaratan bisnis mereka. riskTips: label subkategori. riskWords: kata-kata berisiko. customizedWords: Kata-kata yang disesuaikan. customizedLibs: pustaka kustom. translatedContent: Konten yang diterjemahkan.
AccountId	String	10123****	ID akun Alibaba Cloud. Catatan Jika Anda menentukan parameter accountId dalam permintaan, nilai parameter accountId dikembalikan dalam respons.
DeviceId	String	20240307****	ID perangkat. Catatan Jika Anda menentukan parameter deviceId dalam permintaan, nilai parameter deviceId dikembalikan dalam respons.

Contoh

Permintaan Contoh

{
    "Service": "comment_multilingual_global",
    "ServiceParameters": {
        "content": "testing content",
        "accountId": "10123****"
    }
}

Respons Contoh:

Jika kedua istilah dalam pustaka istilah kustom dan kata-kata berisiko terdeteksi, kode contoh berikut dikembalikan:

{
    "Code": 200,
    "Data": {
        "Labels": "C_customized,profanity",
        "Reason": "{\"riskLevel\":\"high\",\"customizedWords\":\"HXXXXX\",\"detectedLanguage\":\"en\",\"riskTips\":\"sexuality_Suggestive\",\"riskWords\":\"pxxxxy\",\"translatedContent\":\"pxxxxy sxxxx,HXXXXX\",\"customizedLibs\":\"ZXXXXX\"}"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Jika hanya istilah dalam pustaka istilah kustom yang terdeteksi, kode contoh berikut dikembalikan:

{
    "Code": 200,
    "Data": {
        "Labels": "C_customized",
        "Reason": "{\"riskLevel\":\"high\",\"customizedWords\":\"HXXXXX\",\"detectedLanguage\":\"en\",\"translatedContent\":\"HXXXXX\",\"customizedLibs\":\"ZXXXXX\"}"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Jika hanya kata-kata berisiko yang terdeteksi, kode contoh berikut dikembalikan:

{
    "Code": 200,
    "Data": {
        "Labels": "sexuality",
        "Reason": "{\"riskLevel\":\"high\",\"detectedLanguage\":\"ar\",\"riskTips\":\"sexuality_Suggestive\",\"riskWords\":\"pxxxxy\",\"translatedContent\":\"pxxxxy sxxxx\"}"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Jika tidak ada istilah dalam pustaka istilah kustom maupun kata-kata berisiko yang terdeteksi, kode contoh berikut dikembalikan:

{
    "Code": 200,
    "Data": {
        "Labels": "",
        "Reason": "{\"detectedLanguage\":\"en\",\"translatedContent\":\"AXXXXXX\"}"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Deskripsi
200	OK	Permintaan berhasil.
400	BAD_REQUEST	Permintaan salah. Mungkin disebabkan oleh parameter permintaan yang tidak valid. Periksa parameter permintaan dengan cermat.
407	NOT_SUPPORT	Bahasa tidak diidentifikasi atau tidak didukung.
408	PERMISSION_DENY	Mungkin akun Anda tidak diizinkan, akun Anda jatuh tempo, akun Anda tidak diaktifkan, atau akun Anda dilarang.
500	GENERAL_ERROR	Kesalahan. Kesalahan sementara mungkin terjadi di server. Kami sarankan Anda mencoba lagi. Jika kode kesalahan tetap ada, ajukan tiket di Dukungan dan Layanan.
581	TIMEOUT	Operasi habis waktu. Kami sarankan Anda mencoba lagi. Jika kode kesalahan tetap ada, ajukan tiket di Dukungan dan Layanan.
588	EXCEED_QUOTA	QPS melebihi kuota.