全部产品
Search
文档中心

:FAQ tentang API Content Moderation

更新时间:Jun 28, 2025

Halaman ini menjawab pertanyaan umum (FAQ) terkait API Content Moderation.

Dapatkah beberapa hasil moderasi dikembalikan setiap kali operasi asinkron dari Content Moderation dipanggil?

Tidak, beberapa hasil moderasi tidak dapat dikembalikan setiap kali operasi asinkron dari Content Moderation dipanggil.

Bagaimana cara menanyakan statistik panggilan API Content Moderation?

Konsol Content Moderation mengumpulkan statistik panggilan API Content Moderation. Anda dapat menanyakan jumlah panggilan API Content Moderation untuk memoderasi gambar, video, dan teks selama setahun terakhir. Untuk informasi lebih lanjut, lihat Lihat Statistik.

Operasi mana yang dapat saya panggil untuk memoderasi teks?

Anda dapat memanggil operasi /green/text/scan untuk memoderasi teks terhadap pelanggaran. Untuk informasi lebih lanjut tentang operasi /green/text/scan, lihat /green/text/scan.

Bagaimana cara memberikan umpan balik mengenai kesalahan dalam hasil moderasi teks?

Jika Anda menemukan bahwa hasil moderasi teks tidak sesuai harapan, Anda dapat memanggil operasi /green/text/feedback untuk memberikan umpan balik. Untuk informasi lebih lanjut, lihat /green/text/feedback.

Bagaimana cara melihat deskripsi parameter yang dikembalikan setelah operasi Content Moderation dipanggil?

Anda dapat melihat deskripsi parameter respons umum dan kode status HTTP umum, yang disediakan di Parameter Umum.

Dapatkah saya menyertakan informasi tanda tangan permintaan API dalam badan permintaan?

Tidak, informasi tanda tangan harus disertakan dalam header permintaan. Anda harus menyetel parameter tanda tangan di header Authorization dari permintaan HTTP untuk menentukan informasi tanda tangan untuk verifikasi. Kami menyarankan Anda menggunakan SDK Content Moderation. Content Moderation menyediakan SDK dalam berbagai bahasa pemrograman seperti Java, Python, dan PHP. Untuk informasi lebih lanjut, lihat Parameter Umum dan Ikhtisar SDK.

Dapatkah URL yang mengarah ke konten yang tidak diinginkan dalam teks dideteksi selama moderasi teks?

Tidak, moderasi teks hanya dapat mendeteksi pelanggaran berbasis teks, bukan URL yang mengarah ke konten yang tidak diinginkan.

Berapa lama waktu yang dibutuhkan untuk memoderasi konten dengan memanggil operasi Content Moderation?

Durasi moderasi bervariasi tergantung pada jenis objek yang akan dimoderasi.

  • Gambar: Dibutuhkan sekitar 300 ms untuk memoderasi gambar, tidak termasuk durasi unduhan.

  • Video:

    • File video: File video dapat dimoderasi dengan kecepatan sekitar satu hingga enam kali kecepatan pemutaran, tidak termasuk durasi unduhan. Jika kecepatan moderasi adalah enam kali kecepatan pemutaran, dibutuhkan 1 menit untuk memoderasi video 6 menit.

    • Aliran video: Durasi moderasi aliran video bervariasi tergantung pada interval waktu di mana frame ditangkap. Secara umum, hasil moderasi dikembalikan dalam waktu 1 detik setelah frame ditangkap.

  • Teks: Secara umum, hasil moderasi dikembalikan dalam waktu 50 ms.

Dapatkah saya menggunakan Composer untuk mengunduh SDK Content Moderation untuk PHP?

Ya, Anda dapat menggunakan Composer untuk mengunduh SDK Content Moderation untuk PHP, asalkan Composer Anda mendukung PHP 5.3 atau yang lebih baru. Tidak ada tutorial yang disediakan untuk menginstal Composer. Untuk informasi lebih lanjut tentang cara menginstal SDK Content Moderation untuk PHP, lihat Instalasi.

Dapatkah saya memanggil operasi /green/text/scan untuk memoderasi teks bahasa Inggris di Content Moderation?

Ya, Anda dapat memanggil operasi /green/text/scan untuk memoderasi teks bahasa Inggris. Untuk informasi lebih lanjut, lihat /green/text/scan.

Dapatkah saya memanggil operasi moderasi video untuk memoderasi video yang ukurannya lebih besar dari 2 GB di Content Moderation?

Secara default, ukuran video tunggal yang akan dimoderasi tidak boleh melebihi 200 MB. Anda dapat menghubungi dukungan teknis untuk menaikkan batas ukuran hingga 2 GB sesuai kebutuhan. Jika Anda ingin memoderasi video yang ukurannya lebih besar dari 2 GB, kami menyarankan Anda membagi video menjadi beberapa bagian lalu memoderasinya. Secara default, maksimal 200 frame dapat ditangkap dari sebuah video. Jika Anda ingin menangkap lebih banyak frame dari video besar untuk moderasi, Anda harus menyetel parameter maxFrames. Nilai maksimum dari parameter maxFrames adalah 3600 frame. Untuk informasi lebih lanjut, lihat /green/video/asyncscan dan /green/video/results.

Izin apa yang saya butuhkan untuk memanggil operasi Content Moderation? Bagaimana izin tersebut diberikan?

Anda dapat menggunakan ID AccessKey dan Rahasia AccessKey dari pengguna Resource Access Management (RAM) untuk memanggil operasi Content Moderation. Sebelum Anda memanggil operasi Content Moderation sebagai pengguna RAM, izin harus diberikan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Otorisasi Pengguna RAM untuk Memanggil API Content Moderation.

Berapa batas ukuran gambar yang akan dimoderasi di Content Moderation?

Content Moderation dapat memoderasi gambar dengan ukuran tidak lebih dari 20 MB, tinggi atau lebar tidak lebih dari 30.000 piksel, dan resolusi total tidak lebih dari 0,25 miliar piksel. Untuk informasi lebih lanjut, lihat /green/image/scan.

Apa itu batasan konkurensi untuk memanggil operasi Content Moderation?

Batasan konkurensi menentukan jumlah total gambar, video, atau entri teks yang dapat dimoderasi secara bersamaan. Batasan ini berlaku baik untuk metode penagihan bayar sesuai pemakaian maupun paket langganan.

Tabel berikut menjelaskan batasan konkurensi untuk memanggil operasi Content Moderation untuk memoderasi berbagai jenis objek.

Objek Moderasi

Batas Konkurensi Default

Satuan

Deskripsi

Gambar

50

Tidak Ada

Jumlah maksimum gambar yang dapat dimoderasi per detik.

Video

20

Tidak Ada

Jumlah maksimum video yang dapat dimoderasi secara bersamaan. File dan aliran tidak dibedakan.

Teks

100

Tidak Ada

Jumlah maksimum entri teks yang dapat dimoderasi per detik. Setiap entri teks berisi kurang dari 200 karakter.

Catatan
  • Gambar, video, atau entri teks yang dimoderasi dalam batas konkurensi default tidak dikenakan biaya. Untuk menyesuaikan batas konkurensi, hubungi manajer penjualan Anda. Jika Anda menaikkan batas konkurensi, Anda akan dikenakan biaya tambahan.

  • Secara default, jika sebuah objek dimoderasi secara bersamaan dalam beberapa skenario, konkurensi tetap 1. Misalnya, jika Anda mengirim permintaan API untuk memoderasi gambar untuk pornografi dan konten teroris secara bersamaan, konkurensi adalah 1.

Dapatkah saya mengirimkan URL internal objek untuk moderasi?

Tidak, hanya URL publik yang didukung untuk moderasi. Untuk mencegah risiko kebocoran data, kami menyarankan Anda menetapkan periode validitas yang singkat untuk URL publik. Misalnya, Anda dapat menetapkan periode validitas selama 10 menit.

Bagaimana cara memoderasi gambar yang melebihi batas ukuran?

Kami menyarankan Anda mengecilkan ukuran gambar sebelum mengirimkannya untuk moderasi. Saat resolusi gambar lebih besar dari 256 × 256 piksel, resolusi memiliki sedikit dampak pada hasil moderasi.

Dapatkah saya membuat permintaan HTTP untuk memanggil operasi Content Moderation?

Ya, Anda dapat membuat permintaan HTTP untuk memanggil operasi Content Moderation. Namun, Anda harus menandatangani setiap permintaan. Kami menyarankan Anda menggunakan SDK yang disediakan di situs resmi Alibaba Cloud untuk memanggil operasi Content Moderation.

Dapatkah saya menggunakan pasangan AccessKey dari pengguna RAM untuk memanggil operasi Content Moderation?

  • Anda dapat menggunakan pasangan AccessKey dari pengguna RAM untuk memanggil operasi Content Moderation yang versi API-nya adalah V20160621 atau yang lebih baru. Untuk informasi lebih lanjut tentang dependensi yang diperlukan, lihat Ikhtisar SDK.

  • Anda tidak dapat menggunakan pasangan AccessKey dari pengguna RAM untuk memanggil operasi Content Moderation yang versi API-nya lebih awal dari V20160621. Jika tidak, kesalahan AccessDenied akan dikembalikan.

Apakah API Content Moderation menyediakan contoh panggilan?

Ya, API Content Moderation menyediakan contoh panggilan. Contoh panggilan disediakan dalam referensi SDK. Untuk informasi lebih lanjut, lihat Ikhtisar SDK.

Catatan

Tanggal versi contoh panggilan berubah saat API diperbarui. Kami menyarankan Anda memeriksa dokumentasi resmi secara berkala.

Dapatkah saya menggunakan SDK untuk .NET untuk memanggil operasi Content Moderation?

Tidak, kami menyarankan Anda menggunakan SDK Content Moderation untuk bahasa pemrograman lain. Sebagai alternatif, Anda dapat membuat permintaan HTTP untuk memanggil operasi Content Moderation. Untuk informasi lebih lanjut, lihat Ikhtisar SDK dan Sintaks Permintaan.

Dapatkah Content Moderation memoderasi gambar dalam format GIF?

Ya, Content Moderation dapat memoderasi gambar dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP. Untuk informasi lebih lanjut, lihat /green/image/scan.

Dapatkah saya memperpanjang durasi unduhan maksimum dari 3 detik menjadi periode waktu yang lebih lama saat saya memanggil operasi Content Moderation?

Tidak, Anda tidak dapat memperpanjang durasi unduhan maksimum. Jika kesalahan unduhan sering terjadi saat Anda memanggil operasi Content Moderation untuk memoderasi gambar, periksa apakah URL gambar dapat diakses atau apakah gambar dapat diunduh dalam waktu 3 detik. Saat membuat permintaan API, Anda dapat menggunakan titik akhir untuk Content Moderation di wilayah terdekat dengan wilayah tempat server Anda berada. Untuk informasi lebih lanjut, lihat Titik Akhir.

Berapa banyak gambar yang dapat dimoderasi setiap kali operasi /green/image/scan dipanggil di Content Moderation?

Maksimal 100 gambar dapat dimoderasi sekaligus. Untuk memoderasi 100 gambar sekaligus, Anda harus menaikkan batas konkurensi ke nilai lebih dari 100. Secara default, maksimal 50 gambar, 100 entri teks,atau 20 video dapat dimoderasi sekaligus. Untuk informasi lebih lanjut, lihat /green/image/scan dan Penetapan Harga.

Dapatkah saya memanggil satu operasi Content Moderation untuk secara bersamaan memoderasi konten dalam beberapa skenario, seperti deteksi pornografi dan deteksi konten teroris?

Ya, Anda dapat memanggil satu operasi Content Moderation untuk secara bersamaan memoderasi konten dalam beberapa skenario. Untuk melakukannya, atur parameter scenes dalam permintaan API ke beberapa skenario. Misalnya, Anda dapat menyetel parameter scenes ke ["porn","terrorism"] untuk mendeteksi pornografi dan konten teroris dalam gambar. 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. Untuk informasi lebih lanjut, lihat /green/image/scan dan Penetapan Harga.

Nama domain dan port apa saja yang tersedia untuk memanggil operasi Content Moderation?

Jika Anda perlu mengonfigurasi kebijakan keamanan jaringan, kami menyarankan Anda mengaktifkan akses dari *.aliyuncs.com dan mengaktifkan port 80 dan 443.

Bagaimana cara memanggil operasi moderasi video di Content Moderation untuk memoderasi video di ApsaraVideo VOD?

Untuk memanggil operasi moderasi video di Content Moderation untuk memoderasi video di ApsaraVideo VOD, Anda tidak dapat langsung mengirimkan ID video. Anda harus mengirimkan urutan frame yang diambil dari video atau URL yang dapat digunakan untuk mengakses video. Untuk informasi lebih lanjut, lihat /green/video/asyncscan dan /green/video/results.

Dapatkah Content Moderation memoderasi file video M3U8?

Tidak, Content Moderation tidak dapat memoderasi file video M3U8. Content Moderation dapat memoderasi file video dalam format berikut: AVI, FLV, MP4, MPG, ASF, WMV, MOV, WMA, RMVB, RM, FLASH, dan TS. Untuk informasi lebih lanjut, lihat /green/video/asyncscan dan /green/video/results.

Berapa lama tugas asinkron untuk moderasi video berlangsung?

Durasi tugas asinkron untuk moderasi video bervariasi tergantung pada jenis objek yang akan dimoderasi selain durasi pengunduhan objek tersebut.

  • File video: File video dapat dimoderasi dengan kecepatan sekitar satu hingga enam kali kecepatan pemutaran, tidak termasuk durasi unduhan. Jika kecepatan moderasi adalah enam kali kecepatan pemutaran, dibutuhkan 1 menit untuk memoderasi video 6 menit.

  • Aliran video: Durasi moderasi aliran video bervariasi tergantung pada interval waktu di mana frame ditangkap. Secara umum, hasil moderasi dikembalikan dalam waktu 1 detik setelah frame ditangkap.

Dapatkah saya memanggil operasi Content Moderation di wilayah Amerika Serikat untuk memoderasi video?

Ya, Anda dapat memanggil operasi Content Moderation di wilayah Amerika Serikat untuk memoderasi video. Untuk informasi lebih lanjut, lihat Titik Akhir.

Apa perbedaan antara operasi /green/video/syncscan dan /green/video/asyncscan di Content Moderation?

Untuk memanggil operasi /green/video/syncscan, Anda harus mengirimkan urutan frame yang diambil dari video yang akan dimoderasi. Jika Anda ingin mengirimkan URL video untuk menentukan video yang akan dimoderasi, kami menyarankan Anda memanggil operasi /green/video/asyncscan.

Operasi /green/video/asyncscan dapat dipanggil untuk memoderasi file video dan aliran video. Untuk memoderasi file video, Anda dapat mengirimkan urutan frame yang diambil dari file video atau menentukan URL file video. Namun, Anda tidak dapat memperoleh hasil moderasi tugas moderasi asinkron secara real-time. Untuk memperoleh hasil moderasi, Anda dapat menyetel parameter callback dalam permintaan API, atau memanggil operasi /green/video/results untuk memeriksa hasil moderasi. Untuk informasi lebih lanjut, lihat /green/video/syncscan dan /green/video/asyncscan dan /green/video/results.

Dapatkah saya menyetel parameter callback dalam permintaan API untuk moderasi gambar asinkron yang diimplementasikan dengan menggunakan SDK Content Moderation untuk Java?

Ya, Anda dapat menyetel parameter callback dalam permintaan API untuk moderasi gambar asinkron. Untuk informasi lebih lanjut, lihat Moderasi Gambar.

Apa yang ditentukan oleh parameter bizType di Content Moderation?

Parameter bizType menentukan skenario bisnis. Setiap skenario bisnis sesuai dengan kebijakan moderasi. Sebelum Anda menggunakan API Content Moderation, kami menyarankan Anda membuat skenario bisnis kustom berdasarkan kebutuhan bisnis Anda. Setelah Anda menyesuaikan kebijakan moderasi untuk skenario bisnis Anda, Anda dapat menentukan skenario bisnis dalam permintaan API untuk moderasi konten. Dalam hal ini, kebijakan moderasi yang sesuai akan berlaku. Untuk informasi lebih lanjut, lihat Menyesuaikan Kebijakan untuk Moderasi Berbantuan Mesin.

Apa tujuan mengaitkan pustaka teks dengan beberapa skenario bisnis di Content Moderation?

Saat Anda membuat pustaka teks atau gambar kustom, kami menyarankan Anda mengaitkan pustaka teks atau gambar kustom dengan skenario bisnis yang relevan dengan pustaka tersebut. Misalnya, pustaka teks Anda terkait dengan Skenario Bisnis A, dan Anda telah menentukan Skenario Bisnis A dalam permintaan API untuk moderasi teks. Dalam hal ini, pustaka teks yang terkait dengan Skenario Bisnis A digunakan untuk moderasi teks. Jika tidak, semua pustaka teks yang diaktifkan digunakan untuk moderasi teks. Untuk informasi lebih lanjut, lihat Kelola Pustaka Teks Kustom.

Mengapa nilai parameter checksum dalam notifikasi callback berbeda dari nilai yang dihitung setelah saya memanggil operasi /green/video/asyncscan?

Nilai parameter checksum adalah string dalam format <UID> + <Seed> + <Content>. String ini dihasilkan menggunakan algoritma Secure Hash Algorithm 256 (SHA-256). UID menunjukkan ID akun Alibaba Cloud Anda. Anda dapat memperoleh ID tersebut di Konsol Manajemen Alibaba Cloud. Untuk mencegah data dalam notifikasi callback dirusak, Anda dapat menggunakan algoritma SHA-256 untuk menghasilkan string ketika server Anda menerima notifikasi callback. Kemudian, Anda dapat memverifikasi string tersebut terhadap parameter checksum yang diterima. Untuk informasi lebih lanjut, lihat Aktifkan Notifikasi Callback.

Mengapa tidak ada dataId yang dikembalikan setelah saya memanggil operasi /green/text/scan di Content Moderation?

Jika Anda telah menentukan dataId dalam permintaan API untuk operasi /green/text/scan, dataId akan dikembalikan setelah Anda memanggil operasi tersebut. Untuk informasi lebih lanjut, lihat /green/text/scan.

Mengapa label yang berbeda dikembalikan untuk gambar yang sama dalam moderasi skenario tunggal dan multi-skenario?

Secara umum, ini karena konfigurasi dalam beberapa skenario berbeda dari konfigurasi dalam skenario tunggal. Oleh karena itu, konfigurasi tersebut bertentangan ketika gambar yang sama dimoderasi dalam skenario tunggal dan dalam beberapa skenario. Kami menyarankan Anda menghubungi insinyur algoritma untuk memeriksa apakah konfigurasi skenario berbeda. Sebagai alternatif, Anda dapat memoderasi gambar yang sama secara terpisah dalam skenario yang berbeda. Untuk informasi lebih lanjut, lihat /green/image/scan dan Moderasi Gambar.

Mengapa parameter konteks tidak dikembalikan dalam hasil moderasi teks?

Parameter konteks menunjukkan istilah berisiko yang dimuat oleh teks yang dimoderasi. Jika teks yang dimoderasi memuat kebijakan lain seperti model algoritma atau pola teks, parameter ini tidak dikembalikan. Untuk informasi lebih lanjut, lihat /green/text/scan.

Mengapa parameter filteredContent dikembalikan tetapi parameter konteks tidak dikembalikan dalam hasilmoderasi teks?

Parameter filteredContent menunjukkan teks yang dikembalikan setelah istilah yang dimuat dalam teks yang dimoderasi dihapus dengan tanda bintang (*). Jika teks yang dimoderasi memuat istilah atau pola teks tertentu dalam pustaka teks kustom Anda, parameter ini akan dikembalikan. Parameter context menunjukkan istilah berisiko yang dimuat oleh teks yang dimoderasi. Jika teks yang dimoderasi memuat kebijakan lain seperti model algoritma atau pola teks, parameter ini tidak dikembalikan. Untuk informasi lebih lanjut, lihat /green/text/scan.

Mengapa hasil moderasi teks tidak mengandung emoji?

Content Moderation tidak dapat mengenali emoji dalam teks. Karakter emoji disaring dalam hasil moderasi teks yang dikembalikan.

Apakah akurasi dan tingkat recall moderasi gambar sinkron berbeda dari moderasi gambar asinkron di Content Moderation?

Tidak, moderasi gambar sinkron dan moderasi gambar asinkron memiliki efek moderasi yang sama. Satu-satunya perbedaan adalah bahwa mereka diimplementasikan oleh operasi yang berbeda.

Mengapa saya tidak dapat mengunduh kelas utilitas ClientUploader yang digunakan untuk memoderasi file lokal dan file biner untuk SDK Content Moderation untuk Java?

Anda harus mengunduh kelas utilitas ClientUploader untuk SDK Content Moderation untuk Java dan mengimpornya ke proyek Anda. Untuk informasi lebih lanjut tentang URL unduhan dan prosedur, lihat Instalasi.

Mengapa pustaka aliyunsdkcore gagal diinstal untuk SDK Content Moderation untuk Python 3.5.4 dan 3.8.8?

Kami menyarankan Anda menginstal SDK Content Moderation untuk Python 3.x versi utama. Dalam hal ini, jika pustaka aliyunsdkcore masih gagal diinstal, Anda dapat mengunduh pustaka aliyunsdkcore dan mengimpornya ke proyek Anda. Untuk informasi lebih lanjut, lihat Instalasi.

Bagaimana cara menginstal kelas utilitas aliyunsdkgreenextension dari SDK Content Moderation untuk Python?

Anda harus mengunduh kelas utilitas aliyunsdkgreenextension dan mengimpornya ke proyek Anda. Untuk informasi lebih lanjut, lihat Instalasi.

Anda harus mengimpor kelas utilitas aliyunsdkgreenextension ke proyek Anda dengan menggunakan kode berikut:

from aliyunsdkgreenextension.request.extension import HttpContentHelper

Dapatkah pustaka istilah kustom di Content Moderation berisi istilah dalam bahasa selain bahasa Inggris?

Tidak, pustaka istilah kustom di Content Moderation hanya dapat berisi huruf dan angka bahasa Inggris.

Berapa lama masa berlaku URL OSS untuk gambar atau video yang diunggah dari mesin lokal ke OSS untuk moderasi konten?

Masa berlaku URL Layanan Penyimpanan Objek (OSS) adalah 1 jam.

Bagaimana cara saya dikenakan biaya untuk memoderasi aliran video langsung di Content Moderation?

Biaya untuk memoderasi aliran video langsung tergantung pada jumlah frame yang ditangkap dari aliran video langsung. Untuk menghitung jumlah frame yang ditangkap, bagi durasi aliran video langsung dengan interval waktu di mana sebuah frame ditangkap.

Sebagai contoh, durasi aliran video langsung adalah 1 jam dan sebuah frame ditangkap setiap 5 detik. Dalam hal ini, jumlah frame yang ditangkap dihitung dengan menggunakan rumus berikut: 3.600 detik / 5 detik = 720. Oleh karena itu, Anda akan dikenakan biaya untuk 720 frame yang ditangkap.

Bagaimana hasil moderasi dari aliran langsung dikembalikan ke URL callback di Content Moderation?

Di Content Moderation, hasil moderasi dari aliran video langsung dikembalikan secara terpisah. Setiap kali pelanggaran terdeteksi, hasil moderasi dikembalikan. Setelah moderasi aliran langsung selesai, hasil moderasi keseluruhan dikembalikan.

Mengapa URL callback saya masih menerima data setelah Content Moderation berhenti memoderasi aliran langsung?

Setelah pemanggilan API untuk memoderasi aliran langsung berhenti, tugas moderasi yang sesuai juga berhenti. Namun, URL callback Anda masih dapat menerima data tertentu karena adanya latensi rendah.

Apakah tugas untuk memoderasi aliran langsung berhenti jika aliran langsung terputus atau tidak tersedia setelah tugas dikirimkan?

Jika aliran langsung terputus atau tidak tersedia setelah tugas dikirimkan, Content Moderation akan meminta aliran langsung sebanyak tiga kali pada interval tertentu. Interval minimum adalah 10 detik. Jika aliran langsung masih gagal diperoleh dalam waktu 30 detik, tugas akan berhenti.

Kapan kode status 200 dikembalikan dalam moderasi aliran langsung?

Jika moderasi berhasil, kode status 200 dikembalikan. Jika siaran langsung sedang berlangsung, kode status 280 dikembalikan. Jika siaran langsung berakhir atau terputus, kode status 200 dikembalikan.