Imagens compatíveis

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
• PDF
• 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

Observação: a API Vision exige que as imagens sejam suficientemente grandes para que seja possível distinguir recursos importantes da solicitação com facilidade. Tamanhos menores ou maiores do que os recomendados podem funcionar, mas os menores podem diminuir a precisão e os maiores podem aumentar o tempo de processamento e o uso da largura de banda sem favorecer a precisão. O tamanho da imagem não pode ultrapassar 75 milhões de pixels (comprimento x largura) para análise OCR. Se o tamanho da imagem exceder esse tamanho, a API Vision vai redimensionar a imagem. Caso contrário, a API Vision vai usar a imagem original.

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.