/green/image/asyncscan dan /green/image/results - Content Moderation

Memoderasi gambar secara asinkron dan menanyakan hasil moderasi. Anda dapat memanggil operasi /green/image/asyncscan untuk memoderasi gambar terhadap konten berisiko atau ilegal dan menggunakan operasi /green/image/results untuk menanyakan hasil moderasi. Operasi ini mencakup skenario seperti deteksi pornografi, konten teroris, pelanggaran iklan, kode QR (Quick Response), adegan yang tidak diinginkan, dan logo.

Deskripsi operasi /green/image/asyncscan

Operasi: /green/image/asyncscan

Anda dapat memanggil operasi ini untuk mengirimkan tugas moderasi gambar secara asinkron. Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga dapat menggunakan permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Ikhtisar SDK.

Billing method:
Anda akan dikenakan biaya untuk memanggil operasi ini. Untuk informasi lebih lanjut tentang metode penagihan, lihat .
Response timeout:
Waktu tanggapan maksimum yang diizinkan untuk permintaan moderasi sinkron adalah 6 detik. Jika moderasi tidak selesai dalam waktu tersebut, kesalahan timeout akan dikembalikan. Jika hasil moderasi tidak diperlukan secara real-time, Anda dapat mengirimkan permintaan moderasi asinkron. Dalam kebanyakan kasus, disarankan untuk menggunakan operasi moderasi sinkron karena lebih mudah dipanggil. Kami merekomendasikan pengaturan periode timeout menjadi 6 detik untuk operasi moderasi sinkron.
Returned results:
Jika Anda mengirimkan permintaan moderasi asinkron, hasil moderasi tidak dikembalikan secara real-time. Untuk mendapatkan hasilnya, Anda dapat memeriksa hasil moderasi secara berkala atau mengaktifkan notifikasi callback. Hasil moderasi disimpan hingga 1 jam.
- Aktifkan notifikasi callback untuk mendapatkan hasil moderasi: Saat mengirimkan tugas moderasi asinkron, Anda dapat menentukan URL callback untuk menerima hasil moderasi melalui parameter callback dalam permintaan moderasi. Untuk informasi lebih lanjut tentang parameter callback, lihat Parameter Permintaan.
- Periksa hasil moderasi secara berkala: Anda tidak perlu menyetel parameter callback saat mengirimkan tugas moderasi asinkron. Setelah mengirimkan tugas, Anda dapat memanggil operasi /green/image/results untuk menanyakan hasil moderasi. Untuk informasi lebih lanjut tentang operasi ini, lihat Deskripsi operasi /green/image/results.
Limits on images:
- URL gambar harus berupa URL HTTP atau HTTPS.
- Gambar harus dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP.
- Ukuran gambar maksimal adalah 20 MB. Batas ukuran ini berlaku untuk operasi moderasi sinkron dan asinkron.
- Durasi untuk mengunduh gambar dibatasi hingga 3 detik. Jika gambar gagal diunduh dalam waktu tersebut, kesalahan timeout akan dikembalikan.
- Kami merekomendasikan Anda mengirimkan gambar dengan minimal 256 × 256 piksel untuk memastikan efektivitas moderasi.
- Waktu tanggapan operasi untuk memoderasi gambar bervariasi berdasarkan durasi untuk mengunduh gambar tersebut. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal untuk menyimpan gambar yang akan dimoderasi. Kami merekomendasikan penggunaan Object Storage Service (OSS) atau Content Delivery Network (CDN).

Tabel 1. Skenario
Skenario	Deskripsi	Kategori hasil moderasi
Deteksi Pornografi	Mendeteksi konten pornografi atau seksi dalam gambar.	normal, porn, dan seksi
Deteksi Konten Teroris	Mendeteksi konten teroris atau politik dalam gambar.	normal, berdarah, ledakan, pakaian, logo, senjata, politik, kekerasan, kerumunan, parade, tabrakan mobil, bendera, dan lokasi
Deteksi Pelanggaran Iklan	Mendeteksi iklan atau teks pelanggaran dalam gambar.	normal, politik, porn, pelecehan, terorisme, barang terlarang, spam, npx, qrcode, programCode, dan iklan Catatan Anda dapat menyesuaikan kebijakan untuk moderasi berbantuan mesin dan menentukan kategori yang ingin dideteksi berdasarkan persyaratan aktual. Untuk informasi lebih lanjut, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin.
Deteksi Kode QR	Mendeteksi kode QR atau kode program mini dalam gambar.	normal, qrcode, dan programCode Catatan Anda dapat menyesuaikan kebijakan untuk moderasi berbantuan mesin dan menentukan kategori yang ingin dideteksi berdasarkan persyaratan aktual. Untuk informasi lebih lanjut, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin.
Deteksi Adegan Tidak Diinginkan	Mendeteksi adegan yang tidak diinginkan, seperti layar hitam, tepi hitam, gambar gelap, Gambar-dalam-Gambar (PiP), merokok, dan siaran langsung saat mengemudi, dalam gambar.	normal, meaningless, PIP, merokok, dan drivelive
Deteksi Logo	Mendeteksi logo, seperti logo stasiun TV dan merek dagang, dalam gambar.	normal, TV, dan merek dagang

Batas QPS

Anda dapat memanggil operasi ini hingga 50 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, throttling akan dipicu, yang dapat memengaruhi bisnis Anda. Kami merekomendasikan Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter Permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
bizType	String	Tidak	default	Skenario bisnis. Anda dapat membuat skenario bisnis di Content Moderation console. Untuk informasi lebih lanjut, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin.
scenes	StringArray	Ya	["porn"]	Skenario moderasi. Nilai valid: porn: deteksi pornografi terrorism: deteksi konten teroris ad: deteksi pelanggaran iklan qrcode: deteksi kode QR live: deteksi adegan yang tidak diinginkan logo: deteksi logo Anda dapat menentukan beberapa skenario. Misalnya, Anda dapat menentukan porn dan terorisme dalam format `["porn","terorisme"]` untuk mendeteksi konten pornografi dan teroris. Catatan Jika Anda menentukan beberapa skenario untuk moderasi sekaligus, Anda akan dikenakan biaya kumulatif dari semua skenario. Biaya setiap skenario sama dengan jumlah gambar yang dimoderasi dalam skenario tersebut dikalikan dengan harga satuan skenario tersebut.
callback	String	Tidak	http://www.aliyundoc.com	URL callback untuk memberi tahu Anda tentang hasil moderasi asinkron. URL HTTP dan HTTPS didukung. Jika Anda tidak menyetel parameter ini, Anda harus memeriksa hasil moderasi secara berkala. Jika Anda menyetel parameter callback dalam permintaan moderasi, pastikan URL HTTP atau HTTPS yang ditentukan memenuhi persyaratan berikut: mendukung metode POST, menggunakan UTF-8 untuk mengkodekan data yang ditransmisikan, dan mendukung parameter checksum dan content. Untuk mengirimkan hasil moderasi ke URL callback yang ditentukan, Content Moderation mengembalikan parameter checksum dan content dalam notifikasi callback berdasarkan aturan dan format berikut: checksum: string dalam format UID + Seed + Content yang dihasilkan oleh algoritma Secure Hash Algorithm 256 (SHA-256). UID menunjukkan ID akun Alibaba Cloud Anda. Anda dapat menanyakan ID di Konsol Manajemen Alibaba Cloud. Untuk mencegah pemalsuan data, Anda dapat menggunakan algoritma SHA-256 untuk menghasilkan string ketika server Anda menerima notifikasi callback dan memverifikasi string tersebut terhadap parameter checksum yang diterima. Catatan UID harus berupa ID akun Alibaba Cloud, bukan ID pengguna RAM. content: string dalam format JSON yang akan diurai ke dalam data callback dalam format JSON. Untuk informasi lebih lanjut tentang format parameter content, lihat contoh respons sukses dari setiap operasi yang dapat Anda panggil untuk menanyakan hasil moderasi asinkron. Catatan Jika server Anda berhasil menerima notifikasi callback, server mengirimkan kode status HTTP 200 ke Content Moderation. Jika server Anda gagal menerima notifikasi callback, server mengirimkan kode status HTTP lainnya ke Content Moderation. Jika server Anda gagal menerima notifikasi callback, Content Moderation akan terus mendorong notifikasi callback hingga server Anda menerimanya. Content Moderation dapat mendorong notifikasi callback hingga 16 kali berturut-turut. Setelah 16 kali, Content Moderation berhenti mendorong notifikasi callback. Dalam hal ini, kami merekomendasikan Anda memeriksa status URL callback.
seed	String	Tidak	abc_123	String acak yang digunakan untuk menghasilkan tanda tangan untuk permintaan notifikasi callback. String ini dapat memiliki panjang hingga 64 karakter dan dapat berisi huruf, digit, dan garis bawah (_). Anda dapat menyesuaikan string ini. String ini digunakan untuk memverifikasi permintaan notifikasi callback ketika Content Moderation mendorong notifikasi callback ke server Anda. Catatan Parameter ini wajib jika Anda menyetel parameter callback.
cryptType	String	Tidak	SHA256	Algoritma enkripsi yang digunakan untuk mengenkripsi konten notifikasi callback ketika Anda mengaktifkan notifikasi callback. Content Moderation mengenkripsi string yang dikembalikan menggunakan algoritma enkripsi yang Anda tentukan dan mengirimkan string terenkripsi ke URL callback. String yang dikembalikan dalam format `UID + Seed + Content`. Nilai valid: SHA256: Algoritma enkripsi HMAC-SHA256 digunakan sebagai nilai default. SM3: Algoritma enkripsi HMAC-SM3 digunakan, dan string heksadesimal dikembalikan. String ini terdiri dari huruf kecil dan digit. Sebagai contoh, 66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0 dikembalikan setelah Anda mengenkripsi abc menggunakan algoritma enkripsi HMAC-SM3.
offline	Boolean	Tidak	false	Menentukan apakah akan mengaktifkan mode moderasi nearline atau mode moderasi real-time. Nilai valid: true: mengaktifkan mode moderasi nearline. Dalam mode ini, tugas moderasi yang Anda kirimkan mungkin tidak diproses secara real-time, tetapi dapat diantrekan untuk diproses dan akan dimulai dalam waktu 24 jam. false: mengaktifkan mode moderasi real-time. Ini adalah nilai default. Dalam mode ini, Content Moderation menolak permintaan moderasi melebihi batas konkurensi.
tasks	JSONArray	Ya		Daftar objek yang ingin Anda moderasi. Array JSON dapat berisi satu atau lebih elemen. Setiap elemen adalah struktur. Array JSON dapat berisi hingga 100 elemen. Dengan kata lain, Anda dapat mengirimkan hingga 100 objek sekaligus. Untuk mengirimkan 100 objek sekaligus, Anda harus menaikkan batas konkurensi terkait menjadi angka lebih besar dari 100. Untuk informasi lebih lanjut tentang struktur setiap elemen, lihat task.

Tabel 1. task
Parameter	Tipe	Wajib	Contoh	Deskripsi
clientInfo	JSONObject	Tidak	{"userId":"12023****","userNick":"Mike","userType":"others"}	Informasi tentang klien. Untuk informasi lebih lanjut, lihat bagian "Parameter permintaan umum" dari Parameter Umum. Server menentukan apakah akan menggunakan parameter global clientInfo atau parameter clientInfo yang dijelaskan dalam tabel ini. Catatan Parameter clientInfo dalam tabel ini memiliki prioritas lebih tinggi daripada yang global.
dataId	String	Tidak	test4lNSMdggA0c56MMvfYoh4e-1mwxpx	ID objek moderasi. ID dapat berisi huruf, digit, garis bawah (_), tanda hubung (-), dan titik (.). Panjangnya bisa mencapai 128 karakter. ID ini secara unik mengidentifikasi data bisnis Anda.
url	String	Ya	https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png	URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter.
extras	JSONObject	Tidak		Parameter tambahan yang dapat Anda tentukan untuk memanggil operasi ini. Parameter ini tidak diperlukan untuk moderasi gambar.
interval	Integer	Tidak	1	Interval antara dua frame yang diambil secara berturut-turut. Parameter ini khusus untuk moderasi GIF atau gambar panjang. Gambar GIF dapat dianggap sebagai array frame. Satu frame diambil untuk moderasi dari setiap n frame, di mana n ditentukan oleh parameter interval. Sistem hanya menangkap frame dari gambar GIF ketika parameter ini ditentukan. Gambar panjang dapat ditampilkan dalam mode potret atau horizontal. Untuk memoderasi gambar potret panjang, di mana tinggi lebih besar dari 400 piksel dan rasio tinggi terhadap lebar lebih besar dari 2,5, Anda dapat membagi tinggi dengan lebar dan membulatkan hasilnya ke bilangan bulat terdekat sebagai jumlah total frame. Untuk memoderasi gambar horizontal panjang, di mana lebar lebih besar dari 400 piksel dan rasio lebar terhadap tinggi lebih besar dari 2,5, Anda dapat membagi lebar dengan tinggi dan membulatkan hasilnya ke bilangan bulat terdekat sebagai jumlah total frame. Secara default, hanya frame pertama dari gambar GIF atau gambar panjang yang dimoderasi. Anda dapat menggunakan parameter interval untuk menentukan interval antara dua frame yang sistem tangkap secara berturut-turut. Ini membantu mengurangi biaya moderasi. Catatan Parameter interval dan maxFrames harus digunakan berpasangan. Sebagai contoh, parameter interval disetel ke 2 dan parameter maxFrames disetel ke 20 untuk memoderasi gambar GIF atau gambar panjang. Dalam contoh ini, satu dari setiap dua frame dimoderasi dan maksimal 20 frame dapat dimoderasi. Biaya dihitung berdasarkan jumlah frame yang sebenarnya dimoderasi.
maxFrames	Integer	Tidak	20	Jumlah maksimum frame yang akan ditangkap. Parameter ini khusus untuk moderasi GIF atau gambar panjang. Nilai default: 1. Jika nilai parameter interval dikalikan dengan nilai parameter `maxFrames` lebih kecil dari jumlah total frame dalam gambar GIF atau gambar panjang, interval penangkapan frame secara otomatis diubah menjadi bilangan bulat yang dibulatkan ke atas dari hasil pembagian jumlah total frame dalam gambar dengan nilai parameter maxFrames. Ini membantu meningkatkan efek moderasi keseluruhan.

Parameter Respons

Parameter	Tipe	Contoh	Deskripsi
code	Integer	200	Kode status HTTP yang dikembalikan. Untuk informasi lebih lanjut, lihat Kode kesalahan umum.
msg	String	OK	Pesan yang dikembalikan sebagai respons terhadap permintaan.
dataId	String	test4lNSMdggA0c56MMvfYoh4e-1mwxpx	ID objek moderasi. Catatan Jika Anda menyetel parameter dataId dalam permintaan moderasi, nilai parameter permintaan dataId dikembalikan di sini.
taskId	String	fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695	ID tugas moderasi.
url	String	https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png	URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter.

Contoh

Permintaan sampel

http(s)://[Endpoint]/green/image/asyncscan
&<Parameter permintaan umum>
{
    "scenes": [
        "porn"
    ],
    "tasks": [
        {
            "dataId": "test4lNSMdggA0c56MMvfYoh4e-1mwxpx",
            "url": "https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
        }
    ]
}

Respons sukses sampel

{
    "code": 200,
    "msg": "OK",
    "requestId": "95AD868A-F5D2-4AEA-96D4-E0273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "test4lNSMdggA0c56MMvfYoh4e-1mwxpx",
            "taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
            "url": "https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
        }
    ]
}

Deskripsi operasi /green/image/results

Operasi: /green/image/results

Anda dapat memanggil operasi ini untuk menanyakan hasil moderasi gambar asinkron. Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga dapat menggunakan permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Ikhtisar SDK.

Billing method:
Operasi ini gratis.
Response timeout:
Kami merekomendasikan Anda mengatur interval kueri menjadi 30 detik. Dengan cara ini, Anda dapat menanyakan hasil moderasi 30 detik setelah mengirimkan tugas moderasi gambar asinkron dan mendapatkan nilai parameter taskId.
Catatan Jika Anda menyetel parameter offline ke true, periode validitas untuk nilai parameter taskId adalah 24 jam. Jika Anda menyetel parameter offline ke false, periode validitas untuk nilai parameter taskId adalah 1 jam. Nilai default parameter offline adalah false.