AI Guardrails:Deteksi sinkron

Catatan penggunaan

Gunakan operasi API /green/image/scan untuk melakukan deteksi gambar sinkron.

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

• Billing information:

  Anda dikenai biaya untuk memanggil operasi ini. Untuk informasi selengkapnya tentang metode penagihan, lihat

• Detection timeout:

  Waktu respons maksimum yang diizinkan untuk permintaan moderasi sinkron adalah 6 detik. Jika moderasi tidak selesai dalam 6 detik, kesalahan timeout dikembalikan. Jika Anda tidak memerlukan hasil moderasi secara real time, Anda dapat mengirim permintaan moderasi asinkron. Dalam kebanyakan kasus, kami menyarankan Anda mengirim permintaan moderasi sinkron karena operasi moderasi sinkron lebih mudah dipanggil. Kami menyarankan Anda menetapkan periode timeout ke 6 detik saat memanggil operasi moderasi sinkron.

• Return result:

  Secara umum, hasil moderasi dikembalikan dalam waktu 1 detik setelah Anda mengirim permintaan moderasi sinkron. Waktu tersebut dapat meningkat dalam skenario khusus di mana sistem harus memproses sejumlah besar permintaan, ukuran gambar besar, atau gambar berisi banyak kata. Kecepatan OCR berbanding terbalik dengan jumlah kata dalam gambar. Jika gambar yang akan dimoderasi berisi banyak kata, kami menyarankan Anda mengirim permintaan moderasi asinkron.

• Image requirements:

  • URL gambar harus berupa URL HTTP atau HTTPS.

  • Gambar harus dalam format PNG, JPG, JPEG, BMP, GIF, atau WEBP.

  • Ukuran gambar maksimal 20 MB. Batas ukuran gambar ini berlaku untuk operasi moderasi sinkron maupun asinkron.

  • Durasi pengunduhan gambar dibatasi hingga 3 detik. Jika gambar gagal diunduh dalam waktu 3 detik, kesalahan timeout dikembalikan.

  • Kami menyarankan Anda mengirimkan gambar berukuran minimal 256 × 256 piksel untuk memastikan efek moderasi.

  • Waktu respons operasi untuk memoderasi gambar bervariasi tergantung pada durasi pengunduhan gambar tersebut. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal untuk menyimpan gambar yang akan dimoderasi. Kami menyarankan Anda menggunakan Object Storage Service (OSS) atau Content Delivery Network (CDN).

Batas QPS

Anda dapat memanggil operasi ini hingga 10 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, Pembatasan kecepatan akan dipicu. Akibatnya, bisnis Anda mungkin terganggu. Kami menyarankan Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter permintaan

Data yang Dikembalikan

Contoh

http(s)://[Endpoint]/green/image/scan
&<Common request parameters>
{
    "scenes": [
        "ocr"
    ],
    "tasks": [
        {
            "dataId": "test_data_xxxx",
            "url": "https://aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

{
    "code": 200,
    "data": [
        {
            "code": 200,
            "dataId": "test_data_xxxx",
            "extras": {

            },
            "msg": "OK",
            "results": [
                {
                    "label": "ocr",
                    "ocrData": [
                        "hello, this is a test text."
                    ],
                    "ocrLocations": [
                        {
                            "h": 26,
                            "text": "hello",
                            "w": 83,
                            "x": 41,
                            "y": 84
                        },
                        {
                            "h": 25,
                            "text": " this is a test text.",
                            "w": 95,
                            "x": 78,
                            "y": 114
                        }
                    ],
                    "rate": 99.91,
                    "scene": "ocr",
                    "suggestion": "review"
                }
            ],
            "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****",
            "url": "https://aliyundoc.com/test_image_xxxx.png"
        }
    ],
    "msg": "OK",
    "requestId": "C4AB08A9-AD75-4410-859B-0B9EF6DFC3C4"
}