Content Moderation dapat mengirimkan notifikasi asinkron untuk memberi tahu hasil moderasi berbantuan mesin dan tinjauan manual. Jika Anda ingin menggunakan atau mengintegrasikan hasil tersebut untuk tujuan bisnis, Anda dapat mengaktifkan notifikasi callback. Topik ini menjelaskan cara mengaktifkan notifikasi callback untuk API Content Moderation.
Informasi latar belakang
API Content Moderation mendukung notifikasi callback untuk hasil moderasi berbantuan mesin dan hasil tinjauan manual.
Notifikasi callback untuk hasil moderasi berbantuan mesin: Setelah permintaan moderasi diproses, Content Moderation mengirimkan hasil moderasi ke URL callback HTTP yang ditentukan melalui permintaan HTTP POST.
Notifikasi callback untuk hasil tinjauan manual: Setelah Anda meninjau data atau memperbaiki hasil moderasi berbantuan mesin, Content Moderation mengirimkan hasil tinjauan manual ke URL callback HTTP yang ditentukan melalui permintaan HTTP POST. Untuk informasi lebih lanjut, lihat Tinjau Hasil Moderasi Berbantuan Mesin.
Istilah
Tabel berikut memperkenalkan konsep-konsep terkait notifikasi callback.
Istilah | Deskripsi |
callback URL | Titik akhir publik server Anda yang Anda tentukan di Konsol Alibaba Cloud Content Moderation. Callback URL harus memenuhi persyaratan berikut:
|
Seed | String yang digunakan untuk memverifikasi apakah permintaan POST dikirim dari Content Moderation ke URL callback HTTP yang ditentukan. |
waktu callback | Jumlah kali Content Moderation mendorong notifikasi callback ke server Anda. Jika server Anda menerima notifikasi callback, ia mengirimkan kode status HTTP 200 ke Content Moderation. Jika server Anda gagal menerima notifikasi callback, ia mengirimkan kode status HTTP lainnya ke Content Moderation. Setelah Content Moderation menerima kode status HTTP selain 200, Content Moderation akan terus mendorong notifikasi callback hingga server Anda menerimanya. Content Moderation dapat mendorong notifikasi callback berulang kali hingga maksimal 3 kali. |
data callback | Isi notifikasi callback yang dikirim oleh Content Moderation ke URL callback yang ditentukan. Untuk informasi lebih lanjut tentang parameter dalam data callback, lihat Parameter dalam data callback. |
Tabel 1. Parameter dalam Data Callback
Nama | Tipe | Deskripsi |
checksum | String | String dalam format Catatan Untuk mencegah pemalsuan data, Anda dapat menggunakan algoritma SHA-256 untuk menghasilkan string ketika server Anda menerima notifikasi callback dan memverifikasi string tersebut terhadap nilai checksum yang diterima. |
content | String | String berformat JSON yang akan diurai menjadi data callback dalam format JSON. Untuk informasi lebih lanjut tentang data callback yang diurai dari parameter content, lihat bagian Deskripsi parameter content dari topik ini. |
Notifikasi callback untuk hasil moderasi berbantuan mesin
Semua operasi moderasi asinkron API Content Moderation mendukung notifikasi callback, termasuk moderasi gambar asinkron dan moderasi video asinkron. Untuk informasi lebih lanjut, lihat Moderasi Gambar Asinkron dan Moderasi Video Asinkron. Jika Anda memanggil operasi asinkron dan memerlukan Content Moderation untuk mengembalikan hasil moderasi, atur parameter callback dan seed dalam permintaan moderasi Anda. Parameter callback menentukan URL callback, dan parameter seed menentukan string yang digunakan untuk memverifikasi permintaan notifikasi callback.
Jika Anda tidak mengatur parameter sebelumnya saat memanggil operasi asinkron, Anda hanya dapat memeriksa hasil moderasi asinkron pada interval waktu tertentu.
Prosedur
Siapkan URL callback HTTP dan parameter seed yang digunakan untuk menerima hasil moderasi.
Saat memanggil operasi asinkron untuk moderasi konten, atur parameter callback dan seed dalam permintaan moderasi Anda. Untuk informasi lebih lanjut, lihat deskripsi parameter dari operasi API terkait.
Notifikasi callback untuk hasil tinjauan manual
Jika Anda mengirimkan permintaan tinjauan manual, hasil tinjauan tidak dikembalikan secara real-time. Anda harus mengonfigurasi notifikasi callback untuk menerima hasil tinjauan manual.
Menggunakan Layanan Moderasi Berbantuan Mesin dan Tinjauan Manual
Jika Anda menggunakan layanan moderasi berbantuan mesin dan tinjauan manual, Anda harus mengonfigurasi notifikasi callback untuk hasil tinjauan manual di Konsol Content Moderation. Untuk mengonfigurasi notifikasi callback di konsol, ikuti langkah-langkah berikut:
Masuk ke Konsol Content Moderation.
Di panel navigasi sisi kiri, pilih .
Di halaman Machine audit, klik tab Notification. Lalu klik Create New Notification di tab ini.
Di kotak dialog Create New Notification, atur parameter Title, Callback URL, Encryption algorithm, Notification type, dan Audit Result. Lalu, klik OK.
Setelah Anda mengonfigurasi notifikasi callback, sistem secara otomatis menghasilkan nilai untuk parameter seed. Anda dapat menggunakan nilai parameter seed untuk memverifikasi apakah permintaan notifikasi callback dikirim dari Alibaba Cloud. Simpan nilai yang dihasilkan dari parameter seed.
PentingJika Anda telah mengonfigurasi notifikasi callback untuk hasil moderasi berbantuan mesin, Anda dapat menggunakan kembali konfigurasi notifikasi callback atau mengonfigurasi notifikasi callback lain berdasarkan kebutuhan bisnis Anda.
Anda dapat mengonfigurasi notifikasi callback untuk menerima semua hasil moderasi atau hanya hasil moderasi tertentu berdasarkan skenario bisnis Anda.
Pilih Manual Review Results by AlibabaCloud untuk parameter Jenis notifikasi.
Nilai valid untuk parameter Algoritma enkripsi:
SHA256: Algoritma enkripsi HMAC-SHA256 digunakan.
SM3: Algoritma enkripsi HMAC-SM3 digunakan dan string heksadesimal dikembalikan. String terdiri dari huruf kecil dan digit.
Sebagai contoh, 66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0 dikembalikan setelah Anda mengenkripsi abc menggunakan algoritma enkripsi HMAC-SM3.
Di tab BizType Manage, temukan skenario bisnis yang ingin Anda kelola, klik Choose Notification Plan di kolom Actions, dan kemudian pilih skema notifikasi callback dari daftar drop-down Callback notification scheme untuk skenario bisnis tersebut.
Deskripsi parameter content
Setelah Anda mengaktifkan notifikasi callback, Content Moderation mengirimkan hasil moderasi yang dihasilkan oleh API Content Moderation dalam notifikasi callback ke URL callback yang ditentukan. Notifikasi callback berisi parameter content. Tabel berikut menjelaskan struktur parameter content.
Tabel 2. Struktur Parameter Content
Elemen | Tipe | Wajib | Deskripsi |
scanResult | JSONObject | Tidak | Hasil moderasi berbantuan mesin. Struktur parameter ini bervariasi berdasarkan objek yang dimoderasi, seperti gambar dan video.
|
auditResult | JSONObject | Tidak | Hasil tinjauan manual yang dihasilkan oleh Anda. Parameter ini hanya dikembalikan saat tinjauan manual dilakukan. Untuk informasi lebih lanjut, lihat auditResult. Catatan Parameter ini tidak dikembalikan jika Content Moderation hanya mengirimkan hasil moderasi berbantuan mesin. |
humanAuditResult | JSONObject | Tidak | Hasil tinjauan manual yang dihasilkan oleh layanan tinjauan manual Alibaba Cloud. Parameter ini hanya dikembalikan jika Anda membeli layanan tinjauan manual Alibaba Cloud. Untuk informasi lebih lanjut, lihat humanAuditResult. |
Tabel 3. auditResult
Elemen | Tipe | Wajib | Deskripsi |
suggestion | String | Ya | Saran yang Anda berikan selama tinjauan manual. Nilai valid:
|
labels | JSONArray | Tidak | Tag yang Anda tetapkan selama tinjauan manual. Nilai pengembalian bisa satu atau beberapa tag. Nilai valid:
|
Tabel 4. humanAuditResult
Elemen | Tipe | Wajib | Deskripsi |
suggestion | String | Ya | Saran yang diberikan oleh layanan tinjauan manual Alibaba Cloud. Nilai valid:
|
taskId | String | Ya | ID tugas moderasi. Anda dapat mengaitkan hasil tinjauan manual konten dengan hasil moderasi berbantuan mesin yang sesuai berdasarkan ID tugas. |
dataId | String | Ya | ID konten yang dimoderasi. |
labels | JSONArray | Tidak | Tag yang ditetapkan oleh layanan tinjauan manual. Nilai pengembalian dapat berisi beberapa tag. Catatan Secara default, parameter ini tidak dikembalikan. Jika Anda ingin parameter ini dikembalikan, hubungi dukungan teknis Alibaba Cloud dan bayar biaya. |
Contoh Parameter Content
{
"scanResult": {
"code": 200,
"msg": "OK",
"taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
"url": "http://1.jpg",
"results": [
{
"rate": 100,
"scene": "porn",
"suggestion": "block",
"label": "porn"
}
]
},
"auditResult": {
"suggestion": "block",
"labels": [
"porn",
"ad",
"terrorism"
]
},
"humanAuditResult": {
"suggestion": "pass",
"dataId": "yyyy",
"labels": [
"porn",
"vulgar"
],
"taskId": "xxxxxx"
}
}