Verificação de Identidade

O Modelo ID-Selfie verifica a identidade de uma pessoa comparando o documento de identidade com uma selfie em imagem ou vídeo. Ele realiza correspondência facial e verificações anti-spoofing.

Como funciona

Envie um documento de identidade (passaporte, carteira de motorista etc.)
Envie uma selfie em imagem ou vídeo da pessoa
A API compara os rostos e executa verificações anti-spoofing
Você recebe um booleano verified e verificações técnicas detalhadas

Verificando a identidade

Envie ambos os arquivos via POST /v1/verification:

curl -X POST https://api.deepxl.ai/v1/verification \
  -H "x-api-key: YOUR_API_KEY" \
  -F "idFile=@passport.jpg" \
  -F "selfieFile=@selfie.jpg" \
  -F 'tags={"customerId":"9999","customerName":"Acme Corp","documentId":"DOC-001","companyName":"DeepXL","companyId":"COMP-001"}'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`idFile`	file	Sim	Imagem do documento de identificação (passaporte, carteira de motorista etc.)
`selfieFile`	file	Sim	Imagem de selfie ou vídeo da pessoa
`tags`	string	Não	Objeto JSON com pares chave-valor de metadados
`country`	string	Não	Dica opcional de país. Valores compatíveis: `us`, `mx`, `br`. Valores ausentes, vazios ou inválidos assumem o padrão `us`.

Tipos de arquivo suportados

Documento de identidade: jpg, jpeg, png, webp Selfie: jpg, jpeg, png, webp, mp4 (vídeo)

Estrutura de resposta

{
  "result": {
    "verificationId": 5,
    "idFileType": "jpeg",
    "idFileName": "passport.jpg",
    "idFileSize": 174112,
    "selfieFileType": "jpeg",
    "selfieFileName": "selfie.jpg",
    "selfieFileSize": 250118,
    "timestamp": 1770984835,
    "timestampISO": "2026-02-13T13:13:55.213189",
    "model": "verification",
    "modelVersion": "1.0.0",
    "verified": true,
    "modelResults": {
      "technicalChecks": [
        {
          "checkType": "face_detection",
          "faceCount": { "id": 2, "selfie": 1 },
          "idFaces": [
            {
              "faceId": "face_1",
              "detectionConfidence": 0.9992,
              "landmarks": {
                "nose": { "x": 257.7, "y": 946.13 },
                "left_eye": { "x": 287.49, "y": 911.67 },
                "right_eye": { "x": 227.69, "y": 911.25 },
                "mouth_left": { "x": 283.88, "y": 971.12 },
                "mouth_right": { "x": 232.78, "y": 971.0 }
              },
              "boundingBox": { "x1": 195, "x2": 318, "y1": 838, "y2": 1013 }
            },
            {
              "faceId": "face_2",
              "detectionConfidence": 0.9865,
              "landmarks": {
                "nose": { "x": 696.46, "y": 885.83 },
                "left_eye": { "x": 701.44, "y": 879.83 },
                "right_eye": { "x": 690.77, "y": 880.29 },
                "mouth_left": { "x": 701.06, "y": 891.11 },
                "mouth_right": { "x": 692.61, "y": 891.52 }
              },
              "boundingBox": { "x1": 684, "x2": 707, "y1": 866, "y2": 898 }
            }
          ],
          "selfieFaces": [
            {
              "faceId": "face_1",
              "detectionConfidence": 0.9985,
              "landmarks": {
                "nose": { "x": 724.91, "y": 807.64 },
                "left_eye": { "x": 803.63, "y": 708.27 },
                "right_eye": { "x": 649.76, "y": 710.14 },
                "mouth_left": { "x": 793.35, "y": 871.12 },
                "mouth_right": { "x": 659.28, "y": 871.8 }
              },
              "boundingBox": { "x1": 569, "x2": 884, "y1": 523, "y2": 986 }
            }
          ]
        }
      ]
    },
    "tags": [
      { "name": "customerId", "value": "9999" },
      { "name": "customerName", "value": "Acme Corp" },
      { "name": "documentId", "value": "DOC-001" },
      { "name": "companyName", "value": "DeepXL" },
      { "name": "companyId", "value": "COMP-001" }
    ],
    "files": [
      {
        "category": "id",
        "fileName": "passport.jpg",
        "fileSize": 174112,
        "contentType": "image/jpeg",
        "timestamp": 1770984835,
        "timestampISO": "2026-02-13T13:13:55.213189",
        "url": "https://api.deepxl.ai/v1/files/v_id_5_passport.jpg"
      },
      {
        "category": "face",
        "fileName": "selfie.jpg",
        "fileSize": 250118,
        "contentType": "image/jpeg",
        "timestamp": 1770984835,
        "timestampISO": "2026-02-13T13:13:55.213189",
        "url": "https://api.deepxl.ai/v1/files/v_face_5_selfie.jpg"
      }
    ]
  }
}

Referência de campos

Campo	Tipo	Descrição
`verificationId`	integer	Identificador único do registro de verificação
`idFileType`	string	Extensão do arquivo do documento de identidade
`idFileName`	string	Nome original do arquivo do documento de identidade
`idFileSize`	integer	Tamanho do arquivo do documento de identidade em bytes
`selfieFileType`	string	Extensão do arquivo da selfie
`selfieFileName`	string	Nome original do arquivo da selfie
`selfieFileSize`	integer	Tamanho do arquivo da selfie em bytes
`timestamp`	integer	Timestamp Unix da análise
`timestampISO`	string	Timestamp ISO 8601 da análise
`model`	string	Modelo utilizado (`verification`)
`modelVersion`	string	Versão do modelo utilizado para a análise
`verified`	boolean	Se a identidade foi confirmada

Verificado

O campo verified é um booleano que indica se a identidade foi confirmada — o rosto na selfie corresponde ao rosto no documento de identidade e as verificações anti-spoofing foram aprovadas.

Verificações técnicas

O array modelResults.technicalChecks contém resultados de detecção de rosto tanto para o documento de identidade quanto para a selfie. Detecção de rosto (checkType: "face_detection"):

Campo	Tipo	Descrição
`faceCount`	object	Número de rostos detectados — contagem de `id` e contagem de `selfie`
`idFaces`	array	Rostos detectados no documento de identidade
`selfieFaces`	array	Rostos detectados na selfie

Cada objeto de rosto inclui:

Campo	Tipo	Descrição
`faceId`	string	Identificador do rosto (ex.: `face_1`, `face_2`)
`detectionConfidence`	float	Confiança da detecção de rosto (0.0–1.0)
`landmarks`	object	Coordenadas dos pontos de referência faciais (`nose`, `left_eye`, `right_eye`, `mouth_left`, `mouth_right`)
`boundingBox`	object	Coordenadas da caixa delimitadora do rosto (`x1`, `y1`, `x2`, `y2`)

Categorias de arquivo

Categoria	Descrição
`id`	O documento de identidade enviado
`face`	A selfie em imagem ou vídeo enviada

Tags e filtragem

curl "https://api.deepxl.ai/v1/verification?tagFilter=customerId=9999" \
  -H "x-api-key: YOUR_API_KEY"

Navegando pelo histórico

curl "https://api.deepxl.ai/v1/verification?limit=25&offset=0&sortBy=verificationId&direction=desc" \
  -H "x-api-key: YOUR_API_KEY"

Opções de ordenação

verificationId, idFileName, idFileSize, idFileType, selfieFileName, selfieFileSize, selfieFileType, verified, timestamp

Começando

Guias

Verificação de Identidade

Como funciona

Verificando a identidade

Parâmetros

Tipos de arquivo suportados

Estrutura de resposta

Referência de campos

Verificado

Verificações técnicas

Categorias de arquivo

Tags e filtragem

Navegando pelo histórico

Opções de ordenação

​Como funciona

​Verificando a identidade

​Parâmetros

​Tipos de arquivo suportados

​Estrutura de resposta

​Referência de campos

​Verificado

​Verificações técnicas

​Categorias de arquivo

​Tags e filtragem

​Navegando pelo histórico

​Opções de ordenação

Como funciona

Verificando a identidade

Parâmetros

Tipos de arquivo suportados

Estrutura de resposta

Referência de campos

Verificado

Verificações técnicas

Categorias de arquivo

Tags e filtragem

Navegando pelo histórico

Opções de ordenação