Images acceptées

Formats des fichiers

L'API Cloud Vision est compatible avec les types d'images suivants :

  • JPEG
  • PNG8
  • PNG24
  • GIF
  • Animation GIF (première image uniquement)
  • BMP
  • WEBP
  • RAW
  • ICO
  • PDF
  • TIFF

Sachez que certains de ces formats d'image appliquent une compression avec perte (le format JPEG, par exemple). Réduire la définition de ces images peut entraîner une dégradation de leur qualité, et donc de la précision de l'API Vision.

Définition des images

Pour permettre une détection d'image précise par l'API Cloud Vision, les images doivent généralement faire au minimum 640 x 480 pixels (environ 300 000 pixels). Voici les détails complets pour les différents types de requêtes de l'API Vision :

Fonctionnalité de l'API Vision Définition recommandée* Remarques
FACE_DETECTION 1 600 x 1 200 La distance entre les yeux est le facteur le plus important
LANDMARK_DETECTION 640 x 480
LOGO_DETECTION 640 x 480
LABEL_DETECTION 640 x 480
TEXT_DETECTION et DOCUMENT_TEXT_DETECTION 1 024 x 768 La reconnaissance optique des caractères nécessite des résolutions plus élevées afin de pouvoir détecter les caractères
SAFE_SEARCH_DETECTION 640 x 480

Les définitions recommandées diffèrent suivant la fonctionnalité utilisée. Par exemple, les requêtes FACE_DETECTION nécessitent généralement des définitions supérieures, car les caractéristiques détectées (visages) n'occupent qu'une portion de l'image. Les requêtes LABEL_DETECTION, quant à elles, traitent généralement l'ensemble de l'image.

En pratique, une définition de 640 x 480 pixels convient dans la plupart des cas. Les définitions supérieures n'offrent qu'un gain de précision modeste, et réduisent considérablement le débit. Dans la mesure du possible, prétraitez vos images afin que leur définition soit conforme à ces seuils.

Taille du fichier

Les fichiers image envoyés à l'API Cloud Vision ne doivent pas dépasser 20 Mo. Les fichiers dépassant 20 Mo génèrent une erreur. L'API Vision ne redimensionne pas les fichiers de cette taille. Réduire la taille des fichiers peut améliorer considérablement le débit. Veillez cependant à ce que cela ne dégrade pas la qualité des images. Sachez que l'API Vision impose une limite de taille de requête JSON de 10 Mo. Les fichiers plus volumineux doivent être hébergés sur Cloud Storage ou sur le Web, et non pas transmis en tant que contenu encodé en base64 dans le fichier JSON lui-même.