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

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.