Gambar yang Didukung

Format file

Vision API mendukung jenis gambar berikut:

• JPEG
• PNG8
• PNG24
• GIF
• GIF animasi (hanya frame pertama)
• BMP
• WEBP
• RAW
• ICO
• PDF
• TIFF

Perhatikan bahwa beberapa format gambar ini bersifat "lossy" (misalnya, JPEG). Mengurangi ukuran file untuk format lossy tersebut dapat mengakibatkan penurunan kualitas gambar sehingga mempengaruhi akurasi Vision API.

Ukuran gambar

Untuk memungkinkan pendeteksian gambar yang akurat dalam Vision API, gambar pada umumnya harus berukuran minimal 640 x 480 piksel (sekitar 300k piksel). Detail lengkap untuk berbagai jenis permintaan Fitur Vision API ditampilkan di bawah ini:

Fitur Vision API	Ukuran yang direkomendasikan *	Catatan
FACE_DETECTION	1600 x 1200	Jarak antara mata adalah hal yang paling penting
LANDMARK_DETECTION	640 x 480
LOGO_DETECTION	640 x 480
LABEL_DETECTION	640 x 480
TEXT_DETECTION dan DOCUMENT_TEXT_DETECTION	1024 x 768	OCR memerlukan resolusi yang lebih tinggi untuk mendeteksi karakter
SAFE_SEARCH_DETECTION	640 x 480

Catatan: Vision API memerlukan gambar dengan ukuran yang memadai sehingga fitur penting dalam permintaan dapat dibedakan dengan mudah. Ukuran yang lebih kecil atau lebih besar dari ukuran yang direkomendasikan ini dapat digunakan. Namun, ukuran yang lebih kecil dapat menghasilkan akurasi yang lebih rendah, sedangkan ukuran yang lebih besar dapat meningkatkan waktu pemrosesan dan penggunaan bandwidth tanpa memberikan manfaat yang sebanding dalam hal akurasi. Ukuran gambar tidak boleh melebihi 75M piksel (panjang x lebar) untuk analisis OCR. Jika ukuran gambar melebihi 75M piksel (panjang x lebar), Vision API akan mengubah ukuran gambar; jika tidak, Vision API akan menggunakan gambar asli.

Ukuran yang direkomendasikan ini dibedakan berdasarkan fitur yang terdeteksi. Misalnya, permintaan FACE_DETECTION umumnya memerlukan ukuran gambar yang lebih besar karena fitur yang terdeteksi (wajah) lebih kecil daripada gambar itu sendiri. Di sisi lain, permintaan LABEL_DETECTION umumnya mengevaluasi keseluruhan gambar.

Dalam praktiknya, ukuran standar 640 x 480 piksel dalam kebanyakan kasus berfungsi dengan baik; ukuran yang lebih besar dari ukuran ini mungkin tidak akan mendapatkan banyak akurasi, tetapi akan sangat mengurangi throughput. Jika memungkinkan, lakukan pemrosesan awal gambar Anda dengan mengurangi ukurannya hingga mencapai ukuran standar minimum ini.

Ukuran file

File gambar yang dikirim ke Vision API tidak boleh melebihi 20MB. File yang melebihi 20MB akan menghasilkan tampilan error. Vision API tidak mengubah ukuran file sebesar ini. Mengurangi ukuran file dapat meningkatkan throughput secara signifikan; tetapi, berhati-hatilah untuk tidak mengurangi kualitas gambar dalam prosesnya. Perlu diperhatikan bahwa Vision API memberlakukan batas ukuran permintaan JSON sebesar 10MB; file berukuran besar sebaiknya dihosting di Cloud Storage atau di web, bukan diteruskan sebagai konten berenkode base64 di JSON itu sendiri.