Content Moderation：Mengirimkan tugas OCR gambar sinkron

Deskripsi

Operasi: /green/image/scan

Gunakan operasi ini untuk mengirimkan tugas OCR dan mendapatkan hasil secara real-time. Untuk detail tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga dapat menggunakan permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Gambaran SDK.

• Billing method:

  Anda akan dikenakan biaya saat memanggil operasi ini. 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 real-time tidak diperlukan, gunakan permintaan moderasi asinkron. Moderasi sinkron direkomendasikan karena lebih mudah dipanggil, dengan periode timeout disarankan selama 6 detik.

• Returned results:

  Hasil moderasi umumnya dikembalikan dalam waktu 1 detik setelah permintaan sinkron dikirim. Waktu ini dapat meningkat pada skenario khusus, seperti pemrosesan banyak permintaan, ukuran gambar besar, atau gambar dengan banyak teks. Kecepatan OCR berbanding terbalik dengan jumlah kata dalam gambar. Untuk gambar dengan banyak teks, kami merekomendasikan penggunaan permintaan moderasi asinkron.

• Limits on images:

  • URL gambar harus dalam format HTTP atau HTTPS.

  • Format gambar yang didukung adalah PNG, JPG, JPEG, BMP, GIF, atau WEBP.

  • Ukuran maksimal gambar adalah 20 MB. Batas ini berlaku untuk operasi moderasi sinkron dan asinkron.

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

  • Kami merekomendasikan penggunaan gambar minimal 256 × 256 piksel untuk memastikan efektivitas moderasi.

  • Waktu tanggapan operasi bergantung pada durasi pengunduhan gambar. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal, seperti Object Storage Service (OSS) atau Content Delivery Network (CDN).

Batasan QPS

Setiap akun dapat memanggil operasi ini hingga 10 kali per detik. Jika batas ini dilampaui, throttling akan dipicu, yang dapat memengaruhi bisnis Anda. Perhatikan batas ini saat memanggil operasi.

Parameter Permintaan

Parameter Respons

Contoh

http(s)://[Endpoint]/green/image/scan
&<Parameter Permintaan Umum>
{
    "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"
}