/green/video/syncscan - Content Moderation

Memoderasi video dan mendapatkan hasil moderasi secara real-time. Operasi ini dapat digunakan untuk memoderasi video terhadap konten berisiko atau ilegal, mencakup skenario seperti Deteksi pornografi, deteksi konten teroris, deteksi pelanggaran iklan, deteksi adegan yang tidak diinginkan, dan deteksi logo.

Deskripsi

Operasi: /green/video/syncscan

Anda dapat memanggil operasi ini untuk mengirimkan tugas moderasi video dan mendapatkan hasil moderasi secara real-time. Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga dapat memilih permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Gambaran SDK.

Billing method:
Pemanggilan operasi ini dikenakan biaya. Untuk informasi lebih lanjut tentang metode penagihan, lihat
Jika beberapa skenario ditentukan untuk moderasi sekaligus, biaya akan dihitung secara kumulatif dari semua skenario. Biaya setiap skenario sama dengan jumlah frame video yang dimoderasi dalam skenario dikalikan dengan harga satuan skenario tersebut.
Moderated object:
Untuk memanggil operasi /green/video/syncscan, Anda harus mengirimkan urutan frame yang diambil dari video yang akan dimoderasi. Jika ingin mengirimkan URL video untuk menentukan video yang akan dimoderasi, disarankan untuk memanggil operasi /green/video/asyncscan.
Limits on frames captured from a video:
- URL frame video harus berupa URL HTTP atau HTTPS.
- Frame video harus dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP.
- Ukuran frame video maksimal adalah 10 MB.
- Disarankan untuk mengirimkan frame video minimal 256 × 256 piksel untuk memastikan efektivitas moderasi.
- Waktu respons operasi untuk memoderasi video bervariasi berdasarkan durasi pengunduhan frame video. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal untuk menyimpan frame video yang akan dimoderasi. Disarankan untuk menggunakan Object Storage Service (OSS) atau Content Delivery Network (CDN).

Tabel 1. Skenario
Skenario	Deskripsi	Kategori hasil moderasi
Deteksi pornografi	Mendeteksi konten pornografi dalam video.	normal dan porn
Deteksi konten teroris	Mendeteksi konten teroris dalam video.	normal dan terrorism
Deteksi adegan yang tidak diinginkan	Mendeteksi adegan yang tidak diinginkan dalam video.	normal dan live
Deteksi logo	Mendeteksi logo tertentu dalam video.	normal dan logo
Deteksi pelanggaran iklan	Mendeteksi iklan atau pelanggaran teks dalam video.	normal dan ad
Anti-spam audio Catatan Untuk skenario ini, Anda harus memanggil operasi /green/video/asyncscan untuk mengirimkan tugas moderasi video asinkron. Untuk informasi lebih lanjut, lihat /green/video/asyncscan dan /green/video/results.	Mendeteksi anti-spam audio dalam video. Catatan Secara default, audio yang akan dimoderasi harus dalam bahasa Cina. Jika Anda perlu memoderasi audio dalam bahasa Inggris, hubungi manajer penjualan Anda.	normal, spam, ad, politics, terrorism, abuse, porn, flood, contraband, dan customized

Batasan 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. Perhatikan batas ini saat memanggil operasi ini.

Parameter permintaan

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
bizType	String	Tidak	default	Skenario bisnis. Anda dapat membuat skenario bisnis di Konsol Moderasi Konten. Untuk informasi lebih lanjut, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin.
scenes	StringArray	Ya	["porn"]	Skenario moderasi video. Nilai valid: porn: deteksi pornografi terrorism: deteksi konten teroris live: deteksi adegan yang tidak diinginkan logo: deteksi logo ad: deteksi pelanggaran iklan
tasks	JSONArray	Ya		Daftar tugas moderasi yang ingin Anda kirimkan. 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 tugas sekaligus. Untuk mengirimkan 100 tugas sekaligus, Anda harus menaikkan batas konkurensi terkait menjadi angka lebih dari 100. Untuk informasi lebih lanjut tentang struktur setiap elemen, lihat tugas.

Tabel 2. tugas
Parameter	Tipe	Diperlukan	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	videoId****	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.
frames	JSONArray	Ya		Informasi tentang frame yang diambil dari video yang akan dimoderasi. Setiap elemen dalam array JSON parameter frames adalah struktur. Untuk informasi lebih lanjut tentang struktur setiap elemen, lihat frame. Maksimal 200 frame dapat diambil dari setiap video yang akan dimoderasi.
framePrefix	String	Tidak		Prefiks URL frame yang diambil, yang digunakan bersama dengan `frame.url` untuk membentuk URL lengkap frame. URL lengkap frame yang diambil berformat `framePrefix + frame.url`. Untuk informasi lebih lanjut, lihat frame.

Tabel 3. frame
Parameter	Tipe	Diperlukan	Contoh	Deskripsi
url	String	Ya	http://www.aliyundoc.com/test0001.jpg	URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter.
offset	Integer	Tidak	10	Interval antara awal video dan frame yang diambil. Satuan: detik.

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	videoId****	ID objek moderasi. Catatan Jika Anda mengatur parameter dataId dalam permintaan moderasi, nilai parameter dataId permintaan dikembalikan di sini.
taskId	String	taskId****	ID tugas moderasi.
results	JSONArray		Hasil moderasi. Jika pemanggilan berhasil, kode status HTTP 200 dan hasil moderasi dikembalikan. Array hasil moderasi berisi satu atau lebih elemen. Setiap elemen adalah struktur. Untuk informasi lebih lanjut tentang struktur, lihat hasil.

Tabel 4. hasil
Parameter	Tipe	Contoh	Deskripsi
scene	String	porn	Skenario moderasi video yang Anda tentukan dalam permintaan moderasi. Nilai valid: porn: deteksi pornografi terrorism: deteksi konten teroris live: deteksi adegan yang tidak diinginkan logo: deteksi logo ad: deteksi pelanggaran iklan
label	String	porn	Kategori hasil moderasi video. Nilai valid: Jika parameter scenes disetel ke porn, nilai validnya adalah: normal: normal porn: konten pornografi Jika parameter scenes disetel ke terrorism, nilai validnya adalah: normal: normal terrorism: konten teroris Jika parameter scenes disetel ke live, nilai validnya adalah: normal: normal live: adegan yang tidak diinginkan Jika parameter scenes disetel ke logo, nilai validnya adalah: normal: normal logo: logo Jika parameter scenes disetel ke ad, nilai validnya adalah: normal: normal ad: iklan atau pelanggaran teks
sublabel	String	porn	Jika parameter scenes disetel ke porn atau terrorism, subkategori hasil moderasi dapat dikembalikan dalam parameter ini. Parameter ini tidak dikembalikan secara default.
suggestion	String	block	Operasi lanjutan yang direkomendasikan. Nilai valid: pass: Objek yang dimoderasi tidak memerlukan tindakan lebih lanjut. review: Objek yang dimoderasi mengandung pelanggaran yang dicurigai dan memerlukan tinjauan manual. block: Objek yang dimoderasi mengandung pelanggaran. Kami sarankan Anda menghapus atau memblokir objek tersebut.
rate	Float	99.2	Skor tingkat kepercayaan. Nilai valid: 0 hingga 100. Nilai yang lebih besar menunjukkan tingkat kepercayaan yang lebih tinggi. Jika nilai pass dikembalikan untuk parameter suggestion, tingkat kepercayaan yang lebih tinggi menunjukkan kemungkinan lebih besar bahwa kontennya normal. Jika nilai review atau block dikembalikan untuk parameter suggestion, tingkat kepercayaan yang lebih tinggi menunjukkan kemungkinan lebih besar bahwa kontennya mengandung pelanggaran. Penting Kami sarankan Anda menggunakan nilai-nilai yang dikembalikan untuk parameter suggestion, label, dan sublabel untuk menentukan apakah konten mengandung pelanggaran. Parameter sublabel dikembalikan oleh operasi tertentu.
frames	JSONArray		Informasi tentang frame yang diambil yang mengandung pelanggaran. Untuk informasi lebih lanjut tentang struktur, lihat frame.
extras	JSONObject		Informasi tambahan. Jika Anda menentukan ad dalam parameter scenes untuk mendeteksi pelanggaran iklan, parameter extras dapat mengembalikan konten berikut: hitLibInfo: Informasi tentang pustaka teks kustom yang cocok dengan teks yang terdeteksi dalam video yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat hitLibInfo.
hintWordsInfo	JSONArray		Informasi tentang istilah yang cocok dengan teks iklan atau ilegal yang terdeteksi dalam video yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat hintWordsInfo. Catatan Parameter ini hanya berlaku untuk deteksi pelanggaran iklan.
logoData	JSONArray		Informasi tentang logo yang terdeteksi dalam video yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat logoData. Catatan Parameter ini hanya berlaku untuk deteksi logo.
sfaceData	JSONArray		Informasi tentang konten teroris yang terdeteksi dalam video yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat sfaceData. Catatan Parameter ini hanya berlaku untuk deteksi konten teroris.

Tabel 5. frame
Parameter	Tipe	Contoh	Deskripsi
url	String	http://www.aliyundoc.com/0B860000586C0A0300038A0460003	URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter.
offset	Integer	50	Interval antara awal video dan frame yang diambil. Satuan: detik.
label	String	porn	Kategori hasil moderasi frame yang diambil.
rate	Float	99.1	Skor tingkat kepercayaan. Nilai valid: 0 hingga 100. Tingkat kepercayaan yang lebih tinggi menunjukkan keandalan hasil moderasi yang lebih tinggi. Kami sarankan Anda tidak menggunakan skor ini dalam bisnis Anda.

Tabel 6. logoData
Parameter	Tipe	Contoh	Deskripsi
type	String	TV	Tipe logo yang terdeteksi. Sebagai contoh, nilai TV menunjukkan logo media yang dilarang.
name	String	xxx TV	Nama logo yang terdeteksi.
x	Float	140	Jarak antara sudut kiri atas area logo dan sumbu-y, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel.
y	Float	68	Jarak antara sudut kiri atas area logo dan sumbu-x, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel.
w	Float	106	Lebar area logo. Satuan: piksel.
h	Float	106	Tinggi area logo. Satuan: piksel.

Tabel 7. sfaceData
Parameter	Tipe	Contoh	Deskripsi
x	Float	49	Jarak antara sudut kiri atas area wajah dan sumbu-y, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel.
y	Float	39	Jarak antara sudut kiri atas area wajah dan sumbu-x, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel.
w	Float	97	Lebar area wajah. Satuan: piksel.
h	Float	131	Tinggi area wajah. Satuan: piksel.
faces	JSONArray	[{"name":"Hit name","rate":91.54,"id":"AliFace_0123****"}]	Informasi tentang wajah yang dikenali. Setiap elemen dalam array berisi parameter berikut: name: nama orang dengan wajah yang dikenali. Nilainya adalah string. rate: Skor tingkat kepercayaan. Nilai valid: 0 hingga 100. Nilai yang lebih besar menunjukkan tingkat kepercayaan yang lebih tinggi. Tingkat kepercayaan yang lebih tinggi menunjukkan keandalan hasil pengenalan wajah yang lebih tinggi. Nilainya adalah bilangan floating-point. id: ID wajah yang dikenali. Nilainya adalah string.

Tabel 8. hitLibInfo
Parameter	Tipe	Contoh	Deskripsi
context	String	Haokan	Istilah kustom yang cocok dengan teks yang terdeteksi.
libCode	String	123456	Kode pustaka yang berisi istilah kustom yang cocok dengan teks yang terdeteksi.
libName	String	abc	Nama pustaka yang berisi istilah kustom yang cocok dengan teks yang terdeteksi.

Tabel 9. hintWordsInfo
Parameter	Tipe	Contoh	Deskripsi
context	String	Haokan	Istilah yang cocok dengan teks yang terdeteksi.

Contoh

Contoh permintaan

http(s)://[Endpoint]/green/video/syncscan
&<Common request parameters>
{
    "scenes": [
        "porn"
    ],
    "tasks": [
        {
            "dataId": "videoId****",
            "frames": [
                {
                    "offset": 10,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460000"
                },
                {
                    "offset": 20,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460001"
                },
                {
                    "offset": 30,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460002"
                },
                {
                    "offset": 40,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
                },
                {
                    "offset": 50,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
                },
                {
                    "offset": 60,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A046000x"
                }
            ]
        }
    ]
}

Contoh respons sukses

{
    "code": 200,
    "msg": "OK",
    "requestId": "requestID****",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "videoId****",
            "taskId": "taskId****",
            "results": [
                {
                    "label": "porn",
                    "rate": 99.2,
                    "scene": "porn",
                    "suggestion": "block",
                    "frames": [
                        {
                            "offset": 50,
                            "url": "http://www.aliyundoc.comm/0B860000586C0A0300038A0460003",
                            "label": "porn",
                            "rate": 99.1
                        }
                    ]
                }
            ]
        }
    ]
}