AI Guardrails:FAQ tentang API AI Guardrails

Apakah beberapa hasil moderasi dapat dikembalikan setiap kali operasi asinkron AI Guardrails dipanggil?

Tidak. Setiap pemanggilan asinkron hanya mengembalikan satu hasil moderasi.

Bagaimana cara menanyakan statistik pemanggilan API AI Guardrails?

Konsol Moderasi Konten menampilkan jumlah agregat pemanggilan API untuk moderasi gambar, video, teks, selama satu tahun terakhir. Lihat statistik.

Operasi apa yang dapat saya panggil untuk memoderasi teks?

Panggil operasi /green/text/scan untuk memoderasi teks terhadap pelanggaran.

Bagaimana cara memberikan masukan mengenai kesalahan dalam hasil moderasi teks?

Jika hasil moderasi teks tidak akurat, panggil /green/text/feedback untuk melaporkan kesalahan tersebut.

Bagaimana cara melihat deskripsi parameter yang dikembalikan setelah operasi AI Guardrails dipanggil?

Parameter respons umum dan kode status HTTP didokumentasikan dalam Parameter umum.

Dapatkah saya menyertakan informasi signature permintaan API dalam badan permintaan?

Tidak. Signature harus berada di header Authorization. Kami menyarankan menggunakan SDK AI Guardrails (Java, Python, PHP, dll.) daripada menandatangani secara manual. Parameter umum dan Ikhtisar SDK.

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

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

Berapa lama waktu yang dibutuhkan untuk memoderasi konten dengan memanggil operasi AI Guardrails?

Dapatkah saya menggunakan Composer untuk mengunduh SDK AI Guardrails untuk PHP?

Ya, asalkan Composer Anda mendukung PHP 5.3 atau versi yang lebih baru. Instalasi.

Dapatkah saya memanggil operasi /green/text/scan untuk memoderasi teks berbahasa Inggris di AI Guardrails?

Ya. /green/text/scan.

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

Batas ukuran video tunggal default adalah 200 MB. Hubungi dukungan teknis untuk menaikkannya hingga 2 GB. Untuk video yang lebih besar dari 2 GB, segmentasi terlebih dahulu sebelum moderasi. Batas pengambilan frame default adalah 200 (maksimum 3.600). Atur parameter maxFrames untuk video berukuran besar. /green/video/asyncscan dan /green/video/results.

Izin apa yang saya perlukan untuk memanggil operasi AI Guardrails? Bagaimana izin tersebut diberikan?

Gunakan ID AccessKey dan Rahasia AccessKey Pengguna RAM. Pengguna RAM tersebut harus diberikan izin yang diperlukan terlebih dahulu. Otorisasi Pengguna RAM untuk memanggil API AI Guardrails.

Berapa batas ukuran gambar yang akan dimoderasi di AI Guardrails?

Maksimum: ukuran file 20 MB, tinggi atau lebar 30.000 piksel, dan total 0,25 miliar piksel. /green/image/scan.

Apa itu batas konkurensi untuk memanggil operasi AI Guardrails?

Batas konkurensi adalah jumlah total gambar, video, atau entri teks yang dapat dimoderasi secara bersamaan. Ini berlaku untuk penagihan pay-as-you-go maupun subscription.

Dapatkah saya mengirimkan URL internal objek untuk moderasi?

Tidak. Hanya URL yang dapat diakses publik yang didukung. Untuk mencegah kebocoran data, atur periode validitas singkat (misalnya, 10 menit) untuk URL publik.

Bagaimana cara memoderasi gambar yang melebihi batas ukuran?

Kompres gambar sebelum mengirimkannya. Resolusi di atas 256 × 256 piksel memiliki dampak minimal terhadap hasil moderasi.

Dapatkah saya membuat permintaan HTTP untuk memanggil operasi AI Guardrails?

Ya, tetapi setiap permintaan harus ditandatangani. Kami menyarankan menggunakan SDK resmi sebagai gantinya.

Dapatkah saya menggunakan Pasangan AccessKey Pengguna RAM untuk memanggil operasi AI Guardrails?

• Ya, untuk versi API V20160621 atau yang lebih baru. Ikhtisar SDK.

• Tidak, versi sebelum 20160621 tidak mendukung ini. Menggunakan AccessKey Pengguna RAM dengan versi API lama akan mengembalikan error AccessDenied.

Apakah API AI Guardrails menyediakan contoh pemanggilan?

Dapatkah saya menggunakan SDK untuk .NET untuk memanggil operasi AI Guardrails?

Tidak. Gunakan SDK untuk bahasa lain atau buat permintaan HTTP secara langsung. Ikhtisar SDK dan Sintaks permintaan.

Dapatkah AI Guardrails memoderasi gambar dalam format GIF?

Ya. Format yang didukung: PNG, JPG, JPEG, BMP, GIF, dan WEBP. /green/image/scan.

Dapatkah saya memperpanjang durasi unduh maksimum dari 3 detik menjadi periode waktu yang lebih lama saat memanggil operasi AI Guardrails?

Tidak. Jika error unduh sering terjadi, pastikan URL gambar dapat diakses dan merespons dalam waktu 3 detik. Gunakan titik akhir yang paling dekat dengan wilayah server Anda. Titik akhir.

Berapa banyak gambar yang paling banyak dapat dimoderasi setiap kali operasi /green/image/scan dipanggil di AI Guardrails?

Hingga 100 gambar per pemanggilan sinkron. Batas konkurensi Anda harus minimal 100 untuk memproses sebanyak itu. Batas default: 50 gambar/detik, 100 entri teks/detik, 20 aliran video dan audio. Moderasi sinkron dan Harga.

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

Ya. Tentukan beberapa skenario dalam parameter Scenes, misalnya ["porn", "terrorism"]. Anda dikenai biaya per skenario: total biaya = (jumlah gambar) × (harga per skenario). Moderasi sinkron dan Harga.

Nama domain dan port apa saja yang tersedia untuk memanggil operasi AI Guardrails?

Izinkan akses ke *.aliyuncs.com pada port 80 dan 443 dalam kebijakan keamanan jaringan Anda.

Bagaimana cara memanggil operasi moderasi video di AI Guardrails untuk memoderasi video di ApsaraVideo VOD?

API Moderasi Video tidak menerima VideoID dari ApsaraVideo VOD secara langsung. Sebagai gantinya, tangkap frame dan unggah urutan gambarnya, atau berikan URL video yang dapat diakses. Moderasi asinkron.

Dapatkah AI Guardrails memoderasi file video M3U8?

Tidak. Format video yang didukung: AVI, FLV, MP4, MPG, ASF, WMV, MOV, WMA, RMVB, RM, FLASH, dan TS. /green/video/asyncscan dan /green/video/results.

Berapa lama waktu yang dibutuhkan untuk tugas asinkron moderasi video?

Dapatkah saya memanggil operasi AI Guardrails di wilayah Amerika Serikat untuk memoderasi video?

Ya. Titik akhir.

Apa perbedaan antara operasi /green/video/syncscan dan /green/video/asyncscan di AI Guardrails?

Operasi /green/video/syncscan mengharuskan Anda mengirimkan frame yang telah ditangkap sebelumnya. Operasi /green/video/asyncscan menerima URL video secara langsung.

Operasi /green/video/asyncscan mendukung file video dan aliran. Anda dapat mengirimkan frame yang ditangkap atau URL video. Hasil tidak dikembalikan secara real time — atur parameter callback atau polling dengan /green/video/results. /green/video/syncscan dan /green/video/asyncscan dan /green/video/results.

Dapatkah saya mengatur parameter callback dalam permintaan API untuk moderasi gambar asinkron yang diimplementasikan menggunakan SDK AI Guardrails untuk Java?

Ya. Moderasi gambar.

Apa yang ditentukan oleh parameter bizType di AI Guardrails?

Parameter bizType menentukan skenario bisnis, yang dipetakan ke kebijakan moderasi. Buat skenario kustom sesuai kebutuhan Anda, lalu tentukan skenario tersebut dalam permintaan API untuk menerapkan kebijakan yang sesuai. Menyesuaikan kebijakan untuk moderasi berbantuan mesin.

Apa tujuan mengaitkan pustaka teks dengan beberapa skenario bisnis di AI Guardrails?

Kaitkan pustaka teks atau gambar kustom dengan skenario bisnis agar hanya berlaku saat skenario tersebut ditentukan dalam permintaan API. Jika tidak ada skenario yang ditentukan, semua pustaka yang diaktifkan akan digunakan. Kelola pustaka teks kustom.

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

Checksum adalah Hash SHA-256 dari <UID> + <Seed> + <Content>. UID adalah ID akun Alibaba Cloud Anda (ditemukan di Konsol). Saat server Anda menerima callback, hitung ulang hash tersebut dan verifikasi terhadap checksum yang diterima untuk mendeteksi adanya manipulasi. Aktifkan notifikasi callback.

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

Jika Anda menyertakan parameter DataId dalam permintaan moderasi teks Anda, respons API akan menyertakan DataId yang sesuai. Untuk informasi lebih lanjut, lihat Moderasi teks sinkron.

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

Hal ini biasanya terjadi karena konfigurasi skenario tunggal dan multi-skenario berbeda. Hubungi insinyur algoritma untuk memeriksa konflik konfigurasi, atau moderasi gambar tersebut di setiap skenario secara terpisah. /green/image/scan dan Moderasi gambar.

Mengapa parameter context tidak dikembalikan dalam hasil moderasi teks?

Parameter context mengembalikan istilah berisiko yang memicu kecocokan. Jika teks ditandai oleh kebijakan lain seperti model algoritma atau pola teks, parameter ini tidak dikembalikan. /green/text/scan.

Mengapa parameter filteredContent dikembalikan tetapi parameter context tidak dikembalikan dalam hasil moderasi teks?

Bidang FilteredContent menampilkan teks yang dimoderasi dengan istilah yang terdeteksi diganti dengan tanda bintang (*). Bidang ini dikembalikan jika teks cocok dengan kata kunci kustom atau algoritma berbasis kemiripan. Bidang Context, yang berisi istilah berisiko spesifik, hanya dikembalikan saat kata kunci cocok. Bidang ini tidak dikembalikan jika konten ditandai oleh model algoritma atau kebijakan kemiripan. Untuk informasi lebih lanjut, lihat Moderasi teks sinkron.

Mengapa hasil moderasi teks tidak mengandung emoji?

AI Guardrails tidak dapat mengenali emoji. Karakter emoji difilter dalam hasil moderasi yang dikembalikan.

Apakah akurasi dan tingkat recall moderasi gambar sinkron berbeda dari moderasi gambar asinkron di AI Guardrails?

Tidak. Keduanya memiliki efek moderasi yang sama — perbedaannya hanya terletak pada metode pemanggilan (sinkron vs. asinkron).

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

Unduh kelas utilitas ClientUploader dan impor ke dalam proyek Anda. Instalasi.

Mengapa pustaka aliyunsdkcore gagal diinstal untuk SDK AI Guardrails untuk Python 3.5.4 dan 3.8.8?

Gunakan versi Python 3.x utama. Jika instalasi tetap gagal, unduh pustaka aliyunsdkcore secara manual dan impor ke dalam proyek Anda. Instalasi.

Bagaimana cara menginstal kelas utilitas aliyunsdkgreenextension dari SDK AI Guardrails untuk Python?

Unduh kelas utilitas aliyunsdkgreenextension dan impor ke dalam proyek Anda. Instalasi.

from aliyunsdkgreenextension.request.extension import HttpContentHelper

Dapatkah pustaka istilah kustom di AI Guardrails berisi istilah dalam bahasa selain bahasa Inggris?

Tidak. Pustaka istilah kustom hanya mendukung huruf dan angka bahasa Inggris.

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

URL OSS berlaku selama 1 jam.

Bagaimana saya dikenai biaya untuk memoderasi aliran video langsung di AI Guardrails?

Penagihan didasarkan pada jumlah frame yang ditangkap. Bagi durasi aliran dengan interval tangkapan untuk menghitung jumlah frame.

Contoh: aliran berdurasi 1 jam dengan interval tangkapan 5 detik menghasilkan 3.600 ÷ 5 = 720 frame. Anda dikenai biaya untuk 720 frame.

Bagaimana hasil moderasi aliran langsung dikembalikan ke URL callback di AI Guardrails?

Hasil dikembalikan secara individual setiap kali pelanggaran terdeteksi. Setelah moderasi selesai, hasil keseluruhan dikembalikan.

Mengapa URL callback saya masih menerima data setelah AI Guardrails berhenti memoderasi aliran langsung?

Setelah tugas moderasi berhenti, URL callback Anda mungkin masih menerima data sebentar karena latensi.

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

Jika aliran terputus atau tidak tersedia, AI Guardrails mencoba kembali tiga kali dengan interval minimal 10 detik. Jika aliran masih tidak tersedia setelah 30 detik, tugas dihentikan.

Kapan kode status 200 dikembalikan dalam moderasi aliran langsung?

Status 200 dikembalikan ketika moderasi berhasil atau ketika aliran berakhir/terputus. Status 280 menunjukkan bahwa aliran masih dalam proses moderasi.