Moderasi dengan daftar gambar kustom di konsol API

Anda menggunakan API Manajemen Daftar di Azure Content Moderator untuk membuat daftar gambar kustom. Gunakan daftar gambar kustom dengan API moderasi Gambar. Operasi moderasi gambar mengevaluasi gambar Anda. Jika Anda membuat daftar kustom, operasi ini juga membandingkannya dengan gambar dalam daftar kustom Anda. Anda dapat menggunakan daftar kustom untuk memblokir atau mengizinkan gambar.

Catatan

Ada batas maksimum 5 daftar gambar dengan setiap daftar agar tidak melebihi 10.000 gambar.

Anda menggunakan API Manajemen Daftar untuk melakukan tugas-tugas berikut:

  • Membuat daftar.
  • Menambahkan gambar ke daftar.
  • Menyaring gambar dengan gambar di dalam daftar.
  • Menghapus gambar dari daftar.
  • Menghapus daftar.
  • Mengedit informasi daftar.
  • Merefresh indeks sehingga perubahan pada daftar disertakan dalam pemindaian baru.

Menggunakan Konsol API

Sebelum Anda dapat menguji coba API di konsol online, Anda memerlukan kunci langganan Anda. Kunci langganan berada di tab Pengaturan, di kotak Ocp-Apim-Subscription-Key. Untuk informasi selengkapnya, lihat Gambaran Umum.

Refresh indeks pencarian

Setelah Anda membuat perubahan pada daftar gambar, Anda harus me-refresh indeksnya agar perubahan dapat disertakan dalam pemindaian berikutnya. Langkah ini mirip dengan cara mesin cari di desktop Anda (jika diaktifkan) atau mesin cari web terus me-refresh indeksnya untuk menyertakan file atau halaman baru.

  1. Di referensi API Manajemen Daftar Gambar, di menu sebelah kiri, pilih Daftar Gambar, lalu pilih Refresh Indeks Pencarian.

    Halaman Daftar Gambar - Refresh Indeks Pencarian akan terbuka.

  2. Untuk Buka konsol pengujian API, pilih wilayah yang paling menggambarkan lokasi Anda.

    Image Lists - Refresh Search Index page region selection

    Konsol API Daftar Gambar - Refresh Indeks Pencarian akan terbuka.

  3. Di kotak listId, masukkan ID daftar. Masukkan kunci langganan Anda, lalu pilih Kirim.

    Image Lists - Refresh Search Index console Response content box

Buat daftar gambar

  1. Buka referensi API Manajemen Daftar Gambar.

    Halaman Daftar Gambar - Buat akan terbuka.

  2. Untuk Buka konsol pengujian API, pilih wilayah yang paling menggambarkan lokasi Anda.

    Image Lists - Create page region selection

    Konsol API Daftar Gambar - Buat akan terbuka.

  3. Dalam kotak Ocp-Apim-Subscription-Key, masukkan kunci langganan Anda.

  4. Di kotak Isi permintaan, masukkan nilai untuk Nama (misalnya, MyList) dan Deskripsi.

    Image Lists - Create console Request body name and description

  5. Gunakan placeholder pasangan kunci-nilai untuk menetapkan metadata yang lebih deskriptif ke daftar Anda.

    {
        "Name": "MyExclusionList",
        "Description": "MyListDescription",
        "Metadata": 
        {
            "Category": "Competitors",
            "Type": "Exclude"
        }
    }
    

    Tambahkan metadata daftar sebagai pasangan kunci-nilai, dan bukan gambar sebenarnya.

  6. Pilih Kirim. Daftar Anda dibuat. Catat nilai ID yang dikaitkan dengan daftar baru. Anda memerlukan ID ini untuk fungsi manajemen daftar gambar lainnya.

    Image Lists - Create console Response content box shows the list ID

  7. Berikutnya, tambahkan gambar ke MyList. Di menu sebelah kiri, pilih Gambar, lalu pilih Tambahkan Gambar.

    Halaman Gambar - Tambahkan Gambar akan terbuka.

  8. Untuk Buka konsol pengujian API, pilih wilayah yang paling menggambarkan lokasi Anda.

    Image - Add Image page region selection

    Konsol API Gambar - Tambahkan Gambar akan terbuka.

  9. Di kotak listId, masukkan ID daftar yang Anda buat, lalu masukkan URL gambar yang ingin Anda tambahkan. Masukkan kunci langganan Anda, lalu pilih Kirim.

  10. Untuk memverifikasi bahwa gambar telah ditambahkan ke daftar, di menu sebelah kiri, pilih Gambar, lalu pilih Dapatkan Semua ID Gambar.

    Konsol API Gambar - Dapatkan Semua ID Gambar terbuka.

  11. Di kotak listId, masukkan ID daftar, lalu masukkan kunci langganan Anda. Pilih Kirim.

    Image - Get All Image Ids console Response content box lists the images that you entered

  12. Tambahkan beberapa gambar lagi. Sekarang setelah Anda membuat daftar gambar kustom, coba evaluasi gambar dengan menggunakan daftar gambar kustom.

Hapus gambar dan daftar

Menghapus gambar atau daftar sangatlah mudah. Anda dapat menggunakan API untuk melakukan tugas-tugas berikut:

  • Menghapus gambar. (Gambar - Hapus)
  • Hapus semua gambar dalam daftar tanpa menghapus daftar. (Gambar - Hapus Semua Gambar)
  • Menghapus daftar dan semua kontennya. (Daftar Gambar - Hapus)

Contoh ini menghapus satu gambar:

  1. Di referensi API Manajemen Daftar Gambar, di menu sebelah kiri, pilih Gambar, lalu pilih Hapus.

    Halaman Gambar - Hapus akan terbuka.

  2. Untuk Buka konsol pengujian API, pilih wilayah yang paling menggambarkan lokasi Anda.

    Image - Delete page region selection

    Konsol API Gambar - Hapus akan terbuka.

  3. Di kotak listId, masukkan ID daftar untuk menghapus gambar di dalamnya. Ini adalah nomor yang dikembalikan di konsol Gambar - Dapatkan Semua ID Gambar untuk MyList. Kemudian, masukkan ImageId gambar yang akan dihapus.

Di contoh kami, ID daftarnya adalah 58953, nilai untuk ContentSource. ID gambarnya adalah 59021, nilai untuk ContentIds.

  1. Masukkan kunci langganan Anda, lalu pilih Kirim.

  2. Untuk memverifikasi bahwa gambar telah dihapus, gunakan konsol Gambar - Dapatkan Semua ID Gambar.

Ubah informasi daftar

Anda dapat mengedit nama dan deskripsi daftar, dan menambahkan item metadata.

  1. Di Referensi API Manajemen Daftar Gambar, di menu sebelah kiri, pilih Daftar Gambar, lalu pilih Perbarui Detail.

    Halaman Daftar Gambar - Perbarui Detail akan terbuka.

  2. Untuk Buka konsol pengujian API, pilih wilayah yang paling menggambarkan lokasi Anda.

    Image Lists - Update Details page region selection

    Konsol API Daftar Gambar - Perbarui Detail akan terbuka.

  3. Di kotak listId, masukkan ID daftar, lalu masukkan kunci langganan Anda.

  4. Di kotak Isi permintaan, buat editan, lalu pilih tombol Kirim pada halaman tersebut.

    Image Lists - Update Details console Request body edits

Langkah berikutnya

Gunakan REST API dalam kode Anda atau mulai dengan Mulai cepat .NET daftar gambar untuk diintegrasikan dengan aplikasi Anda.