Gunakan /green/video/syncscan untuk moderasi frame video secara real-time - Content Moderation

Topik ini menjelaskan cara memanggil operasi deteksi video sinkron /green/video/syncscan untuk memoderasi konten video. Moderasi video membantu Anda mendeteksi konten yang tidak sesuai dalam video, seperti pornografi, konten teroris dan politik, pelanggaran teks dan gambar, adegan yang tidak diinginkan, serta logo.

Catatan penggunaan

Operasi /green/video/syncscan melakukan deteksi video secara sinkron.

Anda dapat memanggil operasi ini untuk membuat tugas deteksi video sinkron. Untuk informasi selengkapnya tentang cara menyusun permintaan HTTP, lihat Struktur permintaan. Anda juga dapat menggunakan permintaan HTTP yang telah disediakan. Untuk informasi selengkapnya, lihat Ikhtisar SDK.

Billing information:

Anda dikenai biaya setiap kali memanggil operasi ini. Untuk informasi selengkapnya mengenai metode penagihan, lihat .

Jika Anda mendeteksi konten dalam beberapa skenario sekaligus, Anda akan dikenai biaya untuk setiap skenario. Total biaya dihitung sebagai berikut: Jumlah frame video yang dideteksi di setiap skenario × Harga satuan tiap skenario.
Detection object:

Operasi deteksi video sinkron hanya mendukung deteksi terhadap frame video yang telah diunggah. Untuk mendeteksi video dengan mengunggah URL-nya, gunakan operasi deteksi video asinkron.
Video frame requirements:
- URL frame video harus berupa URL HTTP atau HTTPS.
- Frame video harus dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP.
- Ukuran satu frame video maksimal 10 MB.
- Kami menyarankan Anda mengirimkan frame video berukuran minimal 256 × 256 piksel untuk memastikan efektivitas moderasi.
- Waktu respons operasi untuk memoderasi video bervariasi tergantung pada durasi pengunduhan frame yang diambil dari video tersebut. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal untuk menyimpan frame video yang akan dimoderasi. Kami menyarankan Anda menggunakan Object Storage Service (OSS) atau Content Delivery Network (CDN).

Tabel 1. Skenario
Skenario	Deskripsi	Kategori hasil deteksi
Deteksi pornografi	Mendeteksi konten pornografi dalam video.	Normal, Pornografi
Konten kekerasan, teroris, dan politik dalam video	Mendeteksi konten teroris dan politik dalam video.	Normal, Konten terorisme dan politik
Konten Video Tidak Pantas	Mendeteksi adegan yang tidak diinginkan dalam video.	Normal, Adegan tidak diinginkan (seperti layar hitam atau layar putih)
Logo Video	Mendeteksi logo tertentu dalam video.	Normal, Logo
Pelanggaran dalam Video, Gambar, dan Teks	Mendeteksi iklan atau teks yang tidak sesuai dalam video.	Normal, Pelanggaran iklan atau teks
Pelanggaran Konten Video dan Audio Catatan Skenario ini hanya didukung oleh operasi deteksi video asinkron. Untuk menggunakan fitur ini, lihat Deteksi asinkron.	Mendeteksi informasi yang tidak sesuai dalam audio video. Catatan Secara default, bahasa yang didukung adalah bahasa Tionghoa. Untuk mendeteksi konten berbahasa Inggris, hubungi manajer akun Anda.	Normal, Spam, Iklan, Politik, Terorisme, Pelecehan, Pornografi, Flooding, Barang Selundupan, Kustom (misalnya pencocokan kata kunci kustom)

Batas QPS

Anda dapat memanggil operasi ini hingga 50 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas tersebut, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter permintaan

Nama	Tipe	Wajib	Contoh	Deskripsi
bizType	String	Tidak	default	Skenario bisnis. Anda dapat membuat skenario bisnis di Konsol Content Moderation. Untuk informasi selengkapnya, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin.
scenes	StringArray	Ya	["porn"]	Skenario deteksi video. Nilai yang valid: porn: deteksi pornografi terrorism: deteksi konten terorisme dan politik live: deteksi adegan tidak diinginkan logo: Logo video. ad: Konten video, gambar, atau teks yang melanggar
tasks	JSONArray	Ya		Array JSON berisi tugas deteksi. Anda dapat menambahkan hingga 100 elemen ke dalam array ini. Artinya, Anda dapat mengirimkan hingga 100 tugas deteksi sekaligus. Untuk mengirimkan 100 tugas sekaligus, Anda harus meningkatkan batas konkurensi menjadi lebih dari 100. Untuk informasi selengkapnya mengenai struktur tiap elemen, lihat task.

Tabel 2. task
Nama	Tipe	Wajib	Contoh	Deskripsi
clientInfo	JSONObject	Tidak	{"userId":"12023****","userNick":"Mike","userType":"others"}	Informasi mengenai client. Untuk informasi selengkapnya, lihat bagian "Parameter permintaan umum" pada 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 parameter global.
dataId	String	Tidak	videoId****	ID objek moderasi. ID ini dapat berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Panjangnya maksimal 128 karakter. ID ini secara unik mengidentifikasi data bisnis Anda.
frames	JSONArray	Ya		Informasi mengenai frame video yang akan dideteksi. Setiap elemen dalam array frames berupa struct. Untuk informasi selengkapnya mengenai struktur tiap elemen, lihat frame. Anda dapat mendeteksi hingga 200 frame dalam satu video.
framePrefix	String	Tidak		Awalan URL frame. Awalan ini digabungkan dengan `frame.url` untuk membentuk URL lengkap frame tersebut. Format URL lengkap frame video adalah `framePrefix + frame.url`. Untuk informasi selengkapnya, lihat frame.

Tabel 3. frame
Nama	Tipe	Wajib	Contoh	Deskripsi
url	String	Ya	http://www.aliyundoc.com/test0001.jpg	URL HTTP atau HTTPS yang dapat diakses melalui Internet. Panjang URL maksimal 2.048 karakter.
offset	Integer	Tidak	10	Timestamp frame video relatif terhadap awal video. Satuan: detik.

Data respons

Nama	Tipe	Contoh	Deskripsi
code	Integer	200	Kode status HTTP yang dikembalikan. Untuk informasi selengkapnya, lihat Kode kesalahan umum.
msg	String	OK	Pesan respons untuk permintaan tersebut.
dataId	String	videoId****	ID objek moderasi. Catatan Jika Anda menetapkan parameter dataId dalam permintaan moderasi, nilai parameter permintaan dataId akan dikembalikan di sini.
taskId	String	taskId****	ID tugas deteksi.
results	JSONArray		Hasil deteksi. Jika pemanggilan berhasil (code=200), hasilnya berisi satu atau beberapa elemen. Setiap elemen berupa struct. Untuk informasi selengkapnya mengenai struktur tersebut, lihat result.

Tabel 4. result
Nama	Tipe	Contoh	Deskripsi
scene	String	porn	Skenario deteksi video. Ini sesuai dengan skenario yang ditentukan dalam permintaan. Nilai yang valid: porn: deteksi pornografi terrorism: deteksi konten terorisme dan politik live: deteksi adegan tidak diinginkan logo: Logo video. ad: Konten video, gambar, atau teks yang melanggar
label	String	porn	Kategori hasil deteksi video. Kategori hasil bervariasi tergantung pada skenario deteksi. Rinciannya sebagai berikut: Kategori hasil deteksi pornografi (porn): normal: normal porn: pornografi Kategori hasil deteksi konten terorisme dan politik (terrorism): normal: normal terrorism: konten terorisme dan politik Kategori hasil deteksi adegan tidak diinginkan (live): normal: normal live: mengandung adegan tidak diinginkan Kategori hasil deteksi logo (logo): normal: normal logo: mengandung logo Kategori hasil deteksi pelanggaran teks dan gambar (ad): normal: normal ad: mengandung iklan atau pelanggaran teks
sublabel	String	porn	Jika parameter scenes diatur ke porn atau terrorism, subkategori hasil moderasi dapat dikembalikan dalam parameter ini. Parameter ini tidak dikembalikan secara default.
suggestion	String	block	Aksi lanjutan yang direkomendasikan. Nilai yang valid: pass: Hasilnya normal. Tidak diperlukan tindakan lanjutan. review: Hasilnya tidak pasti. Diperlukan tinjauan manual. block: Hasilnya tidak sesuai. Kami menyarankan Anda menghapus konten tersebut atau membatasi visibilitasnya.
rate	Float	99,2	Skor tingkat kepercayaan. Nilai yang valid: 0 hingga 100. Nilai yang lebih besar menunjukkan tingkat kepercayaan yang lebih tinggi. Jika nilai pass dikembalikan untuk parameter saran, tingkat kepercayaan yang lebih tinggi menunjukkan probabilitas yang lebih tinggi bahwa konten bersifat normal. Jika nilai review atau block dikembalikan untuk parameter saran, tingkat kepercayaan yang lebih tinggi menunjukkan probabilitas yang lebih tinggi bahwa konten mengandung pelanggaran. Penting Kami menyarankan Anda menggunakan nilai yang dikembalikan oleh parameter suggestion, label, dan sublabel untuk menentukan apakah konten mengandung pelanggaran. Parameter sublabel dikembalikan oleh operasi tertentu.
frames	JSONArray		Informasi mengenai frame video yang mengandung konten tidak sesuai. Untuk informasi selengkapnya mengenai struktur tersebut, lihat frame.
extras	JSONObject		Informasi tambahan. Dalam skenario pelanggaran teks dan gambar (ad), parameter ini dapat mengembalikan konten berikut. hitLibInfo: Jika teks dalam video cocok dengan pustaka teks kustom, informasi mengenai pustaka yang cocok tersebut akan dikembalikan. Untuk informasi selengkapnya mengenai struktur tersebut, lihat hitLibInfo.
hintWordsInfo	JSONArray		Jika video mengandung iklan atau pelanggaran teks, informasi mengenai kata kunci berisiko yang terdeteksi akan dikembalikan. Untuk informasi selengkapnya mengenai struktur tersebut, lihat hintWordsInfo. Catatan Hasil ini hanya dikembalikan dalam skenario pelanggaran teks dan gambar (ad).
logoData	JSONArray		Jika video mengandung logo, informasi mengenai logo yang terdeteksi akan dikembalikan. Untuk informasi selengkapnya mengenai struktur tersebut, lihat logoData. Catatan Hasil ini hanya dikembalikan dalam skenario deteksi logo (logo).
sfaceData	JSONArray		Jika video mengandung konten teroris atau politik, informasi mengenai konten yang terdeteksi akan dikembalikan. Untuk informasi selengkapnya mengenai struktur tersebut, lihat sfaceData. Catatan Hasil ini hanya dikembalikan dalam skenario deteksi konten terorisme dan politik (terrorism).

Tabel 5. frame
Nama	Tipe	Nilai Contoh	Deskripsi
url	String	http://www.aliyundoc.com/test0001.jpg	URL HTTP atau HTTPS yang dapat diakses melalui Internet. Panjang URL maksimal 2.048 karakter.
offset	Integer	50	Timestamp frame video relatif terhadap awal video. Satuan: detik.
label	String	porn	Kategori hasil deteksi frame video tersebut.
rate	Float	99,1	Skor tingkat kepercayaan. Nilai yang valid: 0 hingga 100. Tingkat kepercayaan yang lebih tinggi menunjukkan hasil moderasi yang lebih andal. Kami menyarankan Anda tidak menggunakan skor ini dalam bisnis Anda.

Tabel 6. logoData
Nama	Tipe	Contoh	Deskripsi
type	String	TV	Jenis logo yang terdeteksi. Nilainya adalah TV (logo stasiun TV).
name	String	xxx units	Nama logo yang terdeteksi.
x	Float	140	Koordinat x pojok kiri atas area logo. Titik asal berada di pojok kiri atas gambar. Satuan: piksel.
y	Float	68	Koordinat y pojok kiri atas area logo. Titik asal berada di pojok kiri atas gambar. Satuan: piksel.
w	Float	106	Lebar area logo. Satuan: piksel.
h	Float	106	Tinggi area logo. Satuan: piksel.

Tabel 7. sfaceData
Nama	Tipe	Contoh	Deskripsi
x	Float	49	Koordinat x pojok kiri atas area wajah. Titik asal berada di pojok kiri atas gambar. Satuan: piksel.
y	Float	39	Koordinat y pojok kiri atas area wajah. Titik asal berada di pojok kiri atas gambar. Satuan: piksel.
w	Float	97	Lebar area wajah. Satuan: piksel.
h	Float	131	Tinggi area wajah. Satuan: piksel.
faces	JSONArray	[{"name":"Hit Person Name","rate":91.54,"id":"AliFace_0123****"}]	Informasi mengenai wajah yang terdeteksi. Strukturnya sebagai berikut: name: String. Nama orang yang mirip. rate: Bilangan floating-point. Skor kepercayaan. Nilainya berkisar antara 0 (kepercayaan terendah) hingga 100 (kepercayaan tertinggi). Skor kepercayaan yang lebih tinggi menunjukkan hasil pengenalan orang yang lebih andal. id: String. ID wajah.

Tabel 8. hitLibInfo
Nama	Jenis	Contoh	Deskripsi
context	String	Haokan Video	Teks kustom untuk pencocokan teks.
libCode	String	123456	Kode pustaka yang berisi teks yang cocok.
libName	String	abc	Nama pustaka yang berisi teks yang cocok.

Tabel 9. hintWordsInfo
Nama	Tipe	Contoh	Deskripsi
context	String	Good video	Konten kata kunci berisiko yang terdeteksi.

Contoh

Permintaan contoh

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

Respons contoh

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