Melhor imagem

O algoritmo "Best shot" tem a finalidade de escolher o frame com rosto de mais alta qualidade e bem ajustado a partir de um registro em vídeo. Esse algoritmo funciona como parte da Liveness análise, portanto, aqui descrevemos apenas a parte do best shot. A partir da API v6.0.1, o best shot é extraído e retornado na resposta da API por padrão, a menos que seja desativado para uma finalidade específica.

Observe: historicamente, algumas instâncias são configuradas para permitir o Best Shot apenas para determinados gestos.

Etapas de processamento

1. Inicie a análise de forma semelhante a Liveness, mas verifique se extract_best_shot está definido como true conforme mostrado abaixo, ou esta linha é omitida (para a API 6.0.1 e versões mais recentes):

corpo da solicitação

{
  "analyses": [{
    "type": "quality",
    "source_media": ["1111aaaa-11aa-11aa-11aa-111111aaaaaa"], // // opcional; omita para incluir todas as mídias da pasta
    "params" : {
      "extract_best_shot": true // a parte obrigatória para a análise best shot
    }
  }]
}

Se quiser usar um webhook para a resposta, adicione-o ao payload nesta etapa, conforme descrito aqui.

2. Verifique e interprete os resultados da mesma forma que para a análise pura de Liveness análise.

3. A URL para o best shot está localizada na analyses.results_media -> output_images -> original_url resposta em analyses.results_media -> output_images -> original_name = "ResultImage.jpg".