Formatos de arquivo
A API Vision é compatível com os seguintes tipos de imagem:
- JPEG
- PNG8
- PNG24
- GIF
- GIF animado (primeiro quadro apenas)
- BMP
- WEBP
- RAW
- ICO
- TIFF
Observe que alguns desses formatos de imagem têm perdas (por exemplo, JPEG). A redução do tamanho do arquivo para esses formatos "com perdas" pode resultar em uma degradação da qualidade da imagem e, portanto, da precisão da API do Vision.
Dimensionamento da imagem
Para ativar a detecção precisa de imagens na API Vision, as imagens precisam ter, no mínimo, 640 x 480 pixels (cerca de 300.000 pixels). Os detalhes completos dos diferentes tipos de solicitações de recursos da API Vision são mostrados abaixo:
Funcionalidade da API do Vision | Tamanho recomendado* | Observações |
---|---|---|
FACE_DETECTION | 1.600 x 1.200 | A distância entre os olhos é o mais importante |
LANDMARK_DETECTION | 640 x 480 | |
LOGO_DETECTION | 640 x 480 | |
LABEL_DETECTION | 640 x 480 | |
TEXT_DETECTION e DOCUMENT_TEXT_DETECTION | 1.024 x 768 | O OCR requer mais resolução para detectar os caracteres |
SAFE_SEARCH_DETECTION | 640 x 480 |
Esses tamanhos recomendados variam de acordo com o recurso que está sendo detectado. Por exemplo, solicitações FACE_DETECTION
normalmente exigem tamanhos de imagem maiores porque os recursos que estão sendo detectados (rostos) são menores do que a própria imagem.
Solicitações LABEL_DETECTION
, por outro lado, geralmente avaliam uma imagem inteira.
Na prática, o tamanho padrão de 640 x 480 pixels funciona bem na maioria dos casos. Tamanhos maiores do que esse podem não ganhar muito em precisão e ainda diminuir consideravelmente a capacidade. Sempre que possível, processe previamente as imagens para reduzir o tamanho delas a esses padrões mínimos.
Tamanho do arquivo
Os arquivos de imagem enviados para a API Vision não podem exceder 20 MB. Os arquivos maiores que 20 MB geram um erro. A API Vision não redimensiona arquivos desse tamanho. Reduzir o tamanho do arquivo pode melhorar significativamente a capacidade. No entanto, tenha cuidado para não reduzir a qualidade da imagem no processo. Observe que a API Vision impõe um limite de tamanho de solicitação JSON de 10 MB. Arquivos maiores precisam ser hospedados no Cloud Storage ou na Web, em vez de ser transmitidos como conteúdo codificado em base64 no próprio JSON.