Serviços / Biometria

Detecção e recorte de rosto

POST/api/v1/oracle/face/crop

Encontra o maior rosto da imagem e devolve só o recorte, em JPEG — para avatar, miniatura na ficha do cliente ou para arquivar só o rosto do documento.

Envie a imagem em file — foto, HEIC ou PDF; do PDF, vale a primeira página. A resposta é a imagem, não JSON: o log_id vem no header X-Api4devs-Log-Id.

Fonte: Motor próprio · tempo real

Parâmetros

filefileObrigatório

Imagem, HEIC ou PDF contendo um rosto.

file

Exemplo de resposta

Esta rota devolve uma resposta binária. Confira o tipo no cabeçalho Content-Type.

Casos de uso

Foto de perfil padronizada

Gerar avatar recortado a partir da foto que o usuário enviou.

Menos imagem pessoal guardada

Recortar o rosto do documento antes de arquivar, reduzindo o que se guarda de imagem pessoal.

Notas de integração

  • A resposta é `image/jpeg`, sem envelope JSON. `X-Api4devs-Log-Id` e os headers de cota voltam mesmo assim.