Liveness

O algoritmo de detecção de Liveness tem como objetivo detectar uma pessoa viva real em uma mídia.

Requisitos

1. Você está autorizado.

2. Você já criou uma pasta e adicionou sua mídia marcados com as tags corretas nesta pasta. Para a API 4.0.8 e inferiores, observe: a análise de Liveness funciona com vídeos e shotsets, imagens são ignoradas. Se quiser analisar uma imagem, envie-a como um shotset (arquivo compactado) com uma única imagem e marque com o video_selfie_blank tag.

Etapas de processamento

1. Inicie a análise da 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": "quality",
      "source_media": ["1111aaaa-11aa-11aa-11aa-111111aaaaaa"], // opcional; omita para incluir todas as mídias da pasta
      ...
    }
  ]
}

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}}/analyses/ – para todas as análises realizadas na mídia da pasta com o folder_id que você tem da etapa anterior.

Repita a verificação até que oresolution_status e resolution campos mudem de status para qualquer outro, exceto PROCESSING e trate isso como um resultado.

Para a análise de Liveness, localize o confidence_spoofing valor relacionado ao vídeo de que você precisa. Ele indica uma chance de que a pessoa não seja real.

[
  {
    // você pode ter várias análises na lista
    // escolha a que você precisa por analyse_id ou type
    "analysis_id": "1111aaaa-11aa-11aa-11aa-111111aaaaaa",
    "type": "QUALITY",
    "results_media": [
      {
        // se houver várias mídias em uma análise, associe a pontuação com a mídia por source_video_id/source_shots_set_id 
        "source_video_id": "1111aaaa-11aa-11aa-11aa-111111aaaaab", // para mídia shots_set, a chave seria source_shots_set_id 
        "results_data": 
        {
          "confidence_spoofing": 0.05790174 // pontuação quantitativa para esta mídia
        }
      "resolution_status": "SUCCESS", // resolução qualitativa (com base em todas as mídias)
      ...
    ]
    ...
  }
  ...
]