---
title: "Verify face identity (detect + embed + anti-spoof)"
method: POST
path: "/v1/identity/verify/base64"
tags: ["S6 Identity Verification"]
---

# Verify face identity (detect + embed + anti-spoof)

`POST /v1/identity/verify/base64`

## Request

- Base URL: `https://api.brainiall.com`
- URL: `https://api.brainiall.com/v1/identity/verify/base64`
- Auth: HTTP bearer

Detect faces (Brainiall face detector), extract 512-d embeddings (Brainiall Identity engine v1, Apache 2.0), and assess anti-spoofing (Brainiall deepfake module ViT). 154 ms p50 CPU. KYC, fraud detection, access control.

## Request body

- IdentityVerifyRequest
  - `image` string, required: Base64-encoded image (JPEG, PNG, WebP). Max 10 MB.
  - `include` string[]

## Response `200`

Faces detected and analyzed

- IdentityVerifyResponse
  - `request_id` string
  - `processing_ms` integer
  - `faces` IdentityFace[]
    - `box` integer[]: [x, y, w, h] in pixels
    - `detection_confidence` number, float
    - `embedding` number[]: 512-d face embedding (Brainiall Identity engine v1)
    - `antispoof_label` 'real' | 'fake'
    - `antispoof_score` number, float

## Other responses

- `400`: Invalid input
- `401`: Unauthorized
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis.md) · [All operations](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/brainiall/apis/brainiall-specialist-ai-apis/revisions/e44fed29a7b5?raw)
