Memoderasi gambar dan mendapatkan hasil moderasi secara real-time. Operasi ini dapat digunakan untuk memoderasi gambar terhadap konten berisiko atau ilegal, mencakup skenario seperti deteksi pornografi, deteksi konten teroris, deteksi pelanggaran iklan, deteksi kode respons cepat (QR), deteksi adegan yang tidak diinginkan, dan deteksi logo.
Deskripsi
Operasi: /green/image/scan
Anda dapat memanggil operasi ini untuk mengirimkan tugas moderasi gambar dan menerima hasil moderasi secara real-time. Untuk detail 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:
Pemanggilan operasi ini dikenakan biaya. Untuk informasi lebih lanjut tentang metode penagihan, lihat .
- Response timeout:
Waktu tanggapan maksimum untuk permintaan moderasi sinkron adalah 6 detik. Jika moderasi tidak selesai dalam waktu tersebut, kesalahan timeout akan dikembalikan. Jika hasil moderasi real-time tidak diperlukan, Anda dapat mengirimkan permintaan moderasi asinkron. Dalam kebanyakan kasus, disarankan untuk menggunakan permintaan moderasi sinkron karena lebih mudah dipanggil. Kami merekomendasikan menetapkan periode timeout menjadi 6 detik untuk pemanggilan operasi moderasi sinkron.
- Returned results:
Secara umum, hasil moderasi dikembalikan dalam waktu 1 detik setelah pengiriman permintaan moderasi sinkron. Waktu ini dapat meningkat dalam skenario khusus, seperti ketika sistem harus memproses sejumlah besar permintaan, ukuran gambar besar, atau gambar berisi banyak teks.
- Limits on images:
URL gambar harus berupa URL HTTP atau HTTPS.
Gambar harus dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP.
Ukuran gambar tidak boleh melebihi 20 MB. Batasan ini berlaku untuk operasi moderasi sinkron maupun asinkron.
Durasi untuk mengunduh gambar dibatasi hingga 3 detik. Jika gambar gagal diunduh dalam waktu tersebut, kesalahan timeout akan dikembalikan.
Disarankan untuk mengirimkan gambar dengan minimal 256 × 256 piksel untuk memastikan efektivitas moderasi.
Waktu tanggapan operasi untuk memoderasi gambar bervariasi berdasarkan durasi pengunduhan gambar. 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).
| 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 yang 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, tidak bermakna, PIP, merokok, dan siaran langsung saat mengemudi |
| 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. Disarankan untuk 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 Konsol Moderasi Konten. Untuk informasi lebih lanjut, lihat Menyesuaikan kebijakan untuk moderasi berbantuan mesin. |
| scenes | StringArray | Ya | ["porn","terrorism","ad","live","qrcode","logo"] | Skenario moderasi. Nilai valid:
Anda dapat menentukan beberapa skenario. Misalnya, Anda dapat menentukan baik porn maupun terrorism dalam parameter scenes 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. |
| 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, lihat 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 | cfd33235-71a4-468b-8137-a5ffe323**** | 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 | http://www.aliyundoc.com/xxx.jpg | URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter. |
| extras | JSONObject | Tidak | {"hitLibInfo":[{"context":"Haokan","libCode":"2144002","libName":"Text pattern library a"}]} | Parameter tambahan yang dapat Anda tentukan untuk memanggil operasi. Parameter ini tidak diperlukan untuk moderasi gambar. |
| interval | Integer | Tidak | 2 | Interval antara dua frame yang ditangkap secara berturut-turut. Parameter ini digunakan untuk melakukan moderasi GIF atau gambar panjang.
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 ditangkap secara berturut-turut oleh sistem. Ini membantu mengurangi biaya moderasi. Catatan Parameter interval dan maxFrames harus digunakan bersama-sama. Misalnya, parameter interval diatur ke 2 dan parameter maxFrames diatur ke 10 untuk memoderasi gambar GIF atau gambar panjang. Dalam contoh ini, satu dari setiap dua frame dimoderasi, dan maksimal 10 frame dapat dimoderasi. Biaya dihitung berdasarkan jumlah frame yang sebenarnya dimoderasi. |
| maxFrames | Integer | Tidak | 10 | 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 |
Parameter Tanggapan
| 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 tanggapan terhadap permintaan. |
| dataId | String | cfd33235-71a4-468b-8137-a5ffe323**** | ID objek moderasi. Catatan Jika Anda menetapkan parameter dataId dalam permintaan moderasi, nilai parameter dataId permintaan dikembalikan di sini. |
| taskId | String | img4wlJcb7p4wH4lAP3111111-123456 | ID tugas moderasi. |
| url | String | http://www.aliyundoc.com/xxx.jpg | URL HTTP atau HTTPS yang dapat diakses melalui Internet. URL memiliki panjang hingga 2.048 karakter. |
| storedUrl | String | http://www.aliyundoc.com | URL HTTP dari Bucket Object Storage Service (OSS) yang menyimpan bukti gambar. Jika Anda mengaktifkan fitur penyimpanan bukti gambar di bucket OSS, gambar yang sesuai dengan aturan penyimpanan bukti akan disimpan di bucket OSS yang ditentukan. |
| extras | JSONObject | {"hitLibInfo":[{"context":"Haokan","libCode":"2144002","libName":"Text pattern library a"}]} | 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 gambar yang dimoderasi. Parameter ini bertipe array. Untuk informasi lebih lanjut tentang struktur, lihat hitLibInfo. |
| results | JSONArray | Hasil moderasi. Jika panggilan 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 setiap elemen, lihat result. |
| Parameter | Tipe | Contoh | Deskripsi |
| scene | String | porn | Skenario moderasi gambar yang Anda tentukan dalam permintaan moderasi. Nilai valid:
|
| label | String | seksi | Kategori hasil moderasi. Nilai valid:
|
| 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 | Operasi lanjutan yang direkomendasikan. Nilai valid:
|
| rate | Float | 91.54 | 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 probabilitas yang lebih tinggi bahwa konten tersebut normal. Jika nilai review atau block dikembalikan untuk parameter suggestion, tingkat kepercayaan yang lebih tinggi menunjukkan probabilitas yang lebih tinggi bahwa konten tersebut mengandung pelanggaran. Penting Kami merekomendasikan Anda menggunakan nilai yang dikembalikan untuk parameter suggestion, label, dan sublabel untuk menentukan apakah konten tersebut mengandung pelanggaran. Parameter sublabel dikembalikan oleh operasi tertentu. |
| frames | JSONArray | Jika gambar yang dimoderasi terlalu panjang, gambar tersebut dipotong. Parameter ini mengembalikan URL sementara setiap frame dalam gambar yang dipotong. Untuk informasi lebih lanjut tentang struktur, lihat frame. | |
| hintWordsInfo | JSONArray | Informasi tentang istilah yang cocok dengan teks iklan atau pelanggaran yang terdeteksi dalam gambar yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat hintWordsInfo. Catatan Parameter ini hanya berlaku untuk deteksi pelanggaran iklan. Contoh: | |
| qrcodeData | StringArray | ["http://www.aliyundoc.com/01ZZOliO"] | Informasi tentang teks yang termasuk dalam kode QR yang terdeteksi dalam gambar yang dimoderasi. Catatan Parameter ini hanya berlaku untuk deteksi kode QR. |
| qrcodeLocations | JSONArray | Informasi koordinat kode QR yang terdeteksi dalam gambar yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat qrcodeLocation. | |
| programCodeData | JSONArray | Informasi lokasi kode program mini yang terdeteksi dalam gambar yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat programCodeData. Catatan Parameter ini hanya berlaku untuk deteksi kode program mini. Pastikan deteksi kode program mini diaktifkan. | |
| logoData | JSONArray | Informasi tentang logo yang terdeteksi dalam gambar 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 gambar yang dimoderasi. Untuk informasi lebih lanjut tentang struktur, lihat sfaceData. Catatan Parameter ini hanya berlaku untuk deteksi konten teroris. | |
| ocrData | Array | Haokan | Informasi tentang teks lengkap yang terdeteksi dalam gambar yang dimoderasi. Catatan Secara default, parameter ini tidak dikembalikan. |
| Parameter | Tipe | Contoh | Deskripsi |
| rate | Float | 89.85 | Skor tingkat kepercayaan. Nilai valid: 0 hingga 100. Tingkat kepercayaan yang lebih tinggi menunjukkan keandalan hasil moderasi yang lebih tinggi. Kami merekomendasikan Anda untuk tidak menggunakan skor ini dalam bisnis Anda. |
| url | String | http://www.aliyundoc.com/xxx-0.jpg | URL sementara frame dalam gambar yang dipotong. URL ini valid selama 5 menit. |
| Parameter | Tipe | Contoh | Deskripsi |
| x | Float | 11.0 | Jarak antara sudut kiri atas area kode program mini dan sumbu-y, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel. |
| y | Float | 0.0 | Jarak antara sudut kiri atas area kode program mini dan sumbu-x, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel. |
| w | Float | 402.0 | Lebar area kode program mini. Satuan: piksel. |
| h | Float | 413.0 | Tinggi area kode program mini. Satuan: piksel. |
| Parameter | Tipe | Contoh | Deskripsi |
| type | String | TV | Jenis 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. |
| 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":"Nama yang cocok","rate":91.54,"id":"AliFace_0123****"}] | Informasi tentang wajah yang dikenali. Setiap elemen dalam array berisi parameter berikut:
|
| 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. |
| Parameter | Tipe | Contoh | Deskripsi |
| context | String | Haokan | Istilah yang cocok dengan teks yang terdeteksi. |
| Parameter | Tipe | Contoh | Deskripsi |
| x | Float | 11.0 | Jarak antara sudut kiri atas area kode QR dan sumbu-y, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel. |
| y | Float | 0.0 | Jarak antara sudut kiri atas area kode QR dan sumbu-x, dengan sudut kiri atas gambar sebagai titik asal koordinat. Satuan: piksel. |
| w | Float | 402.0 | Lebar area kode QR. Satuan: piksel. |
| h | Float | 413.0 | Tinggi area kode QR. Satuan: piksel. |
| qrcode | String | http://www.aliyundoc.com/0.ZZOliO | URL yang ditunjuk oleh kode QR yang terdeteksi. |
Contoh
http(s)://[Endpoint]/green/image/scan
&<Parameter permintaan umum>
{
"scenes": [
"porn",
"terrorism",
"ad",
"live",
"qrcode",
"logo"
],
"tasks": [
{
"dataId": "uuid-xxxx-xxxx-1234",
"url": "http://www.aliyundoc.com/xxx.jpg"
}
]
}{
"msg": "OK",
"code": 200,
"data": [
{
"msg": "OK",
"code": 200,
"dataId": "cfd33235-71a4-468b-8137-a5ffe323****",
"extras": {
},
"results": [
{
"rate": 99.63,
"suggestion": "block",
"label": "seksi",
"scene": "porn"
},
{
"label": "politik",
"rate": 91.54,
"scene": "terrorism",
"sfaceData": [
{
"faces": [
{
"id": "AliFace_0123****",
"name": "Nama yang cocok",
"rate": 91.54
}
],
"h": 131,
"w": 97,
"x": 49,
"y": 39
}
],
"suggestion": "block"
},
{
"extras": {
"qrcodes": "http://www.aliyundoc.com/0.ZZOliO",
"npx": "72.01",
"hitCustomLibCode": "8012345000",
"hitCustomLibName": "Nama pustaka gambar kustom",
"hitLibInfo": [
{
"context": "Teks yang cocok",
"libCode": "123456",
"libName": "Nama pustaka teks kustom"
}
]
},
"programCodeData": [
{
"w": 402.0,
"h": 413.0,
"x": 11.0,
"y": 0.0
}
],
"frames": [
{
"rate": 89.85,
"url": "http://www.aliyundoc.com/xxx-0.jpg"
},
{
"rate": 68.06,
"url": "http://www.aliyundoc.com/xxx-1.jpg"
}
],
"rate": 99.91,
"suggestion": "block",
"label": "iklan",
"scene": "ad"
},
{
"rate": 99.91,
"suggestion": "block",
"label": "narkoba",
"scene": "live"
},
{
"qrcodeData": [
"http://www.aliyundoc.com/01ZZOliO"
],
"rate": 99.91,
"suggestion": "review",
"label": "qrcode",
"scene": "qrcode"
},
{
"logoData": [
{
"name": "xxx TV",
"type": "TV",
"x": 140,
"y": 68,
"w": 106,
"h": 106
}
],
"rate": 99.9,
"suggestion": "block",
"label": "TV",
"scene": "logo"
}
],
"taskId": "img4wlJcb7p4wH4lAP3111111-123456",
"url": "http://www.aliyundoc.com/xxx.jpg"
}
],
"requestId": "69B41AE8-1234-1234-1234-12D395695D2D"
}