---
title: "Biometria Facial 1:1"
method: POST
path: "/biometrias/facematch"
tags: ["Biometria Facial"]
---

# Biometria Facial 1:1

`POST /biometrias/facematch`

### Descrição

A **Biometria Facial 1:1** é uma tecnologia do **BigID** que compara duas imagens de rosto — como a foto de um documento e uma selfie — para verificar se pertencem à mesma pessoa. Utilizando modelos avançados de Inteligência Artificial, a solução identifica características faciais e calcula um índice de similaridade preciso, permitindo validações de identidade rápidas e seguras.

A tecnologia é indicada para fluxos de autenticação, onboarding digital e prevenção à fraude, podendo operar de forma independente ou integrada a outras soluções do BigID, como a Documentoscopia Digital. Em cenários que exigem maior nível de segurança, a Biometria Facial também pode ser combinada com a [Prova de Vida (Liveness)](/docs/prova-de-vida), reforçando a confiabilidade do processo.

O cliente pode definir o **threshold de aprovação** (percentual mínimo de similaridade) conforme sua política de risco, equilibrando sensibilidade e tolerância a falsos positivos e mitigando tentativas de fraude, como o uso de fotos, vídeos ou imagens reaproveitadas.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Biometria Facial](/docs/biometria-facialfacematch).

### Tabela de preços

A cobrança é realizada conforme o volume mensal de consultas, de acordo com a tabela abaixo:

| Consultas realizadas no mês | Valor por consulta |
|:---------------------------:|:------------------:|
| 1 – 10.000 | R$ 0,170 |
| 10.001 – 50.000 | R$ 0,162 |
| 50.001 – 100.000 | R$ 0,153 |
| 100.001 – 500.000 | R$ 0,146 |
| 500.001 – 1.000.000 | R$ 0,138 |
| 1.000.001 – 5.000.000 | R$ 150.000,00 (preço fixo) |
| Acima de 5.000.000 | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- Request — Objeto de requisição para consulta de biografia generativa. Para mais informações sobre cada parâmetro e sua utilização, consulte a página "Primeiros Passos".
  - `q` string, required — String que define os parâmetros de entrada da consulta, utilizada para informar os identificadores e filtros aplicáveis a biografia generativa.
  - `Datasets` string, required — String contendo os nomes técnicos das biografias generativas s a serem consultadas.
  - `Limit` number — Número máximo de entidades retornadas na resposta, utilizado em consultas realizadas sem uma chave principal. Valor máximo permitido: 80

## Response `200`

Parâmetros de retorno da tecnologia.

- Result — Resultado para a tecnologia BG | Empresa - Nova.
  - `Result` object[], required — Listas de resultados
    - `GenerativeAIData` object[], required — Objeto principal de retorno da biografia generativa, contendo a narrativa textual das informações relacionadas à entidade consultada.
      - `ServiceName` string, required — Indica o nome da tecnologia solicitada (Ex.: 'Life Biography').
      - `ServiceVersion` string, required — Indica o versão da tecnologia solicitada (x1.5, ...).
      - `AIModelName` string, required — Nome da inteligência artificial generativa utilizada para gerar a descrição (GPT-4, Mistral, Nova).
      - `Description` string, required — Descrição gerada pela inteligência artificial generativa para os conjunto de dados de entrada especificados para a entidade consultada.
  - `QueryId` string, required — Id único identificador da chamada.
  - `ElapsedMilliseconds` number, required — A quantidade de milisegundos decorridos durante a chamada.
  - `QueryDate` string, required — A data de quando o request foi recebido e processado.
  - `Status` object, required — Lista de status para cada dataset.
  - `Evidences` object, required — Lista de evidências usadas para cada dataset.

---

[API](https://skmtc.dev/bigdatacorp/apis/bigid.md) · [All operations](https://skmtc.dev/bigdatacorp/apis/bigid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdatacorp/bigid/revisions/74abe72d7efc/schema)