全部产品
Search
文档中心

Content Moderation:Aktifkan notifikasi callback

更新时间:Jul 02, 2025

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:

  • Menggunakan HTTP atau HTTPS dan dapat diakses dari Internet.

  • Mendukung metode POST.

  • Mendukung data yang dikodekan UTF-8.

  • Mendukung data yang diterima dalam format application/x-www-form-urlencoded.

  • Mendukung parameter checksum dan content dalam data callback.

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 <UID> + <Seed> + <Content> yang dihasilkan menggunakan algoritma Secure Hash Algorithm 256 (SHA-256). UID menunjukkan ID akun Alibaba Cloud Anda. Untuk melihat ID akun, Anda dapat masuk ke Konsol Alibaba Cloud dan arahkan kursor ke foto profil di pojok kanan atas.

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.

Catatan

Jika Anda tidak mengatur parameter sebelumnya saat memanggil operasi asinkron, Anda hanya dapat memeriksa hasil moderasi asinkron pada interval waktu tertentu.

Prosedur

  1. Siapkan URL callback HTTP dan parameter seed yang digunakan untuk menerima hasil moderasi.

  2. 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:

    1. Masuk ke Konsol Content Moderation.

    2. Di panel navigasi sisi kiri, pilih Machine audit V1.0 > Settings.

    3. Di halaman Machine audit, klik tab Notification. Lalu klik Create New Notification di tab ini.

    4. 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.

      Penting
      • Jika 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.

    5. 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.

  • Untuk gambar, strukturnya sama dengan parameter results yang dikembalikan sebagai respons terhadap operasi sinkron untuk moderasi gambar. Untuk informasi lebih lanjut, lihat moderasi gambar sinkron.

  • Untuk video, strukturnya sama dengan parameter results yang dikembalikan sebagai respons terhadap operasi asinkron untuk moderasi video. Untuk informasi lebih lanjut, lihat moderasi video asinkron.

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:

  • block

  • pass

labels

JSONArray

Tidak

Tag yang Anda tetapkan selama tinjauan manual. Nilai pengembalian bisa satu atau beberapa tag. Nilai valid:

  • porn: konten pornografi

  • terrorism: konten teroris

  • ad: iklan teks atau gambar

  • live: adegan yang tidak diinginkan

Tabel 4. humanAuditResult

Elemen

Tipe

Wajib

Deskripsi

suggestion

String

Ya

Saran yang diberikan oleh layanan tinjauan manual Alibaba Cloud. Nilai valid:

  • block

  • pass

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"
    }
}