Content Moderation：Mengirimkan tugas OCR gambar asinkron

Deskripsi operasi asinkron

Operasi: /green/image/asyncscan

Anda dapat memanggil operasi ini untuk mengirimkan tugas moderasi gambar asinkron. Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga bisa memilih permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Ikhtisar SDK.

• Billing method:

  Anda akan dikenakan biaya untuk memanggil operasi ini. Untuk informasi lebih lanjut tentang metode penagihan, lihat

• Response timeout:

  Waktu respon maksimum yang diizinkan untuk permintaan moderasi sinkron adalah 6 detik. Jika moderasi tidak selesai dalam 6 detik, kesalahan timeout akan dikembalikan. Jika Anda tidak memerlukan hasil moderasi secara real-time, Anda dapat mengirimkan permintaan moderasi asinkron. Dalam banyak kasus, kami merekomendasikan Anda mengirimkan permintaan moderasi sinkron karena operasi moderasi sinkron lebih mudah dipanggil. Kami merekomendasikan Anda menyetel periode timeout menjadi 6 detik untuk memanggil operasi moderasi sinkron.

• Returned results:

  Jika Anda mengirimkan permintaan moderasi asinkron, hasil moderasi tidak akan dikembalikan secara real-time. Untuk mendapatkan hasil moderasi, Anda dapat memantau hasil moderasi secara berkala atau mengaktifkan notifikasi callback. Hasil moderasi disimpan hingga 1 jam.

  • Aktifkan notifikasi callback untuk mendapatkan hasil moderasi: Saat Anda mengirimkan tugas moderasi asinkron, Anda dapat menentukan URL callback untuk menerima hasil moderasi dalam parameter callback dari permintaan moderasi. Untuk informasi lebih lanjut tentang parameter callback, lihat Parameter Permintaan.

  • Pantau hasil moderasi pada interval reguler: Anda tidak perlu menyetel parameter callback saat mengirimkan tugas moderasi asinkron. Setelah Anda mengirimkan tugas, Anda dapat memanggil operasi /green/video/results untuk menanyakan hasil moderasi. Untuk informasi lebih lanjut tentang operasi, lihat Deskripsi Operasi /green/image/results.

• Limits on images:

  • URL gambar harus berupa URL HTTP atau HTTPS.

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

  • Ukuran gambar tidak boleh lebih dari 20 MB. Batas ukuran gambar berlaku untuk operasi moderasi sinkron maupun asinkron.

  • Durasi untuk mengunduh gambar dibatasi hingga 3 detik. Jika gambar gagal diunduh dalam 3 detik, kesalahan timeout akan dikembalikan.

  • Kami merekomendasikan Anda mengirimkan gambar setidaknya 256 × 256 piksel untuk memastikan efek moderasi.

  • Waktu respon operasi untuk memoderasi gambar bervariasi berdasarkan durasi untuk mengunduh gambar tersebut. Pastikan Anda menggunakan layanan penyimpanan yang stabil dan andal untuk menyimpan gambar yang akan dimoderasi. Kami merekomendasikan 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, throttling akan dipicu. Akibatnya, bisnis Anda mungkin terpengaruh. Kami merekomendasikan Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter Permintaan

Parameter Respons

Contoh

http(s)://[Endpoint]/green/image/asyncscan
&<Parameter permintaan umum>
{
    "scenes": [
        "ocr"
    ],
    "tasks": [
        {
            "dataId": "test_data_xxxx",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

{
    "code": 200,
    "msg": "OK",
    "requestId": "92AD868A-F5D2-4AEA-96D4-E1273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "test_data_xxxx",
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

Deskripsi operasi /green/image/results

Operasi: /green/image/results

Anda dapat memanggil operasi ini untuk menanyakan hasil OCR asinkron.Untuk informasi lebih lanjut tentang cara membuat permintaan HTTP, lihat Struktur Permintaan. Anda juga bisa memilih permintaan HTTP yang sudah ada. Untuk informasi lebih lanjut, lihat Ikhtisar SDK.

• Billing method:

  Operasi ini gratis.

• Response timeout:

  Kami merekomendasikan Anda menanyakan hasil moderasi setidaknya 30 detik setelah Anda mengirimkan permintaan moderasi asinkron. Content Moderation menyimpan hasil moderasi hingga 4 jam. Setelah 4 jam, hasil tersebut dihapus.

Batas QPS

Anda dapat memanggil operasi ini hingga 10 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, throttling akan dipicu. Akibatnya, bisnis Anda mungkin terpengaruh. Kami merekomendasikan Anda memperhatikan batas ini saat memanggil operasi ini.

Parameter Permintaan

Parameter Respons

Contoh

http(s)://[Endpoint]green/image/results
&<Parameter permintaan umum>
[
    "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****"
]

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

            },
            "msg": "OK",
            "results": [
                {
                    "label": "ocr",
                    "ocrData": [
                        "Topik ini menjelaskan cara memanggil operasi untuk mengirimkan tugas moderasi gambar asinkron."
                    ],
                    "ocrLocations": [
                        {
                            "h": 19,
                            "text": "Topik ini menjelaskan cara memanggil operasi untuk mengirimkan tugas moderasi gambar asinkron.",
                            "w": 362,
                            "x": 31,
                            "y": 11
                        }
                    ],
                    "rate": 99.91,
                    "scene": "ocr",
                    "suggestion": "review"
                }
            ],
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ],
    "msg": "OK",
    "requestId": "992C7849-AA45-4055-8F82-8D44D64C15E3"
}