Pular para o conteúdo principal
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

  1. Envie um documento de identidade (passaporte, carteira de motorista etc.)
  2. Envie uma selfie em imagem ou vídeo da pessoa
  3. A API compara os rostos e executa verificações anti-spoofing
  4. 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"}'

​
Parâmetros

ParâmetroTipoObrigatórioDescrição
idFilefileSimImagem do documento de identidade (passaporte, carteira de motorista etc.)
selfieFilefileSimSelfie em imagem ou vídeo da pessoa
tagsstringNãoObjeto JSON com pares chave-valor de metadados

​
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" }
    ],
    "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

CampoTipoDescrição
verificationIdintegerIdentificador único do registro de verificação
idFileTypestringExtensão do arquivo do documento de identidade
idFileNamestringNome original do arquivo do documento de identidade
idFileSizeintegerTamanho do arquivo do documento de identidade em bytes
selfieFileTypestringExtensão do arquivo da selfie
selfieFileNamestringNome original do arquivo da selfie
selfieFileSizeintegerTamanho do arquivo da selfie em bytes
timestampintegerTimestamp Unix da análise
timestampISOstringTimestamp ISO 8601 da análise
modelstringModelo utilizado (verification)
modelVersionstringVersão do modelo utilizado para a análise
verifiedbooleanSe 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"):
CampoTipoDescrição
faceCountobjectNúmero de rostos detectados — contagem de id e contagem de selfie
idFacesarrayRostos detectados no documento de identidade
selfieFacesarrayRostos detectados na selfie
Cada objeto de rosto inclui:
CampoTipoDescrição
faceIdstringIdentificador do rosto (ex.: face_1, face_2)
detectionConfidencefloatConfiança da detecção de rosto (0.0–1.0)
landmarksobjectCoordenadas dos pontos de referência faciais (nose, left_eye, right_eye, mouth_left, mouth_right)
boundingBoxobjectCoordenadas da caixa delimitadora do rosto (x1, y1, x2, y2)

​
Categorias de arquivo

CategoriaDescrição
idO documento de identidade enviado
faceA 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"

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