Biometria (Correspondência facial)

O algoritmo BIOMETRY tem a finalidade de comparar duas ou mais fotos e detectar o nível de similaridade dos rostos detectados. Como mídia de origem, o algoritmo aceita fotos, vídeos e documentos (com fotos).

Requisitos

1. Você está autorizado.

2. Você já criou uma pasta e adicionou sua mídia marcada com tags corretas nesta pasta.

Etapas de processamento

1. Inicie a análise para a pasta: POST /api/folders/{{folder_id}}/analyses/

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

corpo da solicitação

{
  "analyses": [{
    "type": "biometry",
    // opcional; omita para incluir toda a mídia da pasta
    "source_media": [
      "1111aaaa-11aa-11aa-11aa-111111aaaaaa", 
      "2222bbbb-22bb-22bb-22bb-222222bbbbbb" 
      ]
  }]
}

Você precisará deanalysis_id ou folder_id da resposta.

2. Se você usar um webhook, aguarde apenas ele retornar as informações necessárias. Caso contrário, inicie o polling:

• GET /api/analyses/{{analysis_id}} – para o analysis_id que você tem da etapa anterior.

• GET /api/folders/{{folder_id}} – para todas as análises realizadas na mídia da pasta com o folder_id que você tem da etapa anterior.

Repita até que os resolution_status e resolution os campos mudem de status para qualquer outro, exceto PROCESSING, e trate isso como um resultado.

Verifique a resposta para o min_confidence valor. É um resultado quantitativo da correspondência das pessoas na mídia enviada.

[
  {
    // pode haver várias análises na lista
    // escolha a necessária por analyse_id ou type
    "analysis_id": "1111aaaa-11aa-11aa-11aa-111111aaaaaa",
    "type": "BIOMETRY",
    "results_media": [
      {
        // se houver várias mídias em uma análise, associe a pontuação da mídia por source_video_id/source_shots_set_id 
        "source_video_id": "1111aaaa-11aa-11aa-11aa-111111aaaaab", // para mídia de shots_set, a chave seria source_shots_set_id 
        "results_data": 
        {
          "max_confidence": 0.997926354, 
          "min_confidence": 0.997926354 // pontuação quantitativa para esta mídia
        }
      ...
    ]
    "resolution_status": "SUCCESS", // resolução qualitativa (com base em todas as mídias)
    ...
  }
  ...
]