Format file
Vision API mendukung jenis gambar berikut:
- JPEG
- PNG8
- PNG24
- GIF
- GIF animasi (hanya frame pertama)
- BMP
- WEBP
- RAW
- ICO
- 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 |
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.