Как работает Face AI
Полное описание SDK-потока от создания сессии до доставки результата.
Обзор архитектуры
Face AI — это размещённый API. Ваше мобильное приложение интегрирует лёгкий SDK. Ваш бэкенд взаимодействует через REST API. Инфраструктура ИИ не нужна с вашей стороны.
Your Mobile App
Integrates the SDK
Your Backend Server
Calls REST API with API key
Face AI Platform
Processes, stores, callbacks
Полный поток верификации
Бэкенд создаёт сессию
Ваш сервер вызывает POST /api/sdk/v1/session/start с ключом API и внешним ID пользователя. Вы получаете краткосрочный токен сессии.
Примечание: Никогда не передавайте ключ API в мобильное приложение.
Передайте токен мобильному SDK
Ваш бэкенд передаёт session_token мобильному приложению. SDK использует этот токен для всех последующих вызовов.
Примечание: Токен истекает через 15 минут.
SDK захватывает медиа
SDK открывает камеру, проводит пользователя через захват лица и загружает файл на POST /api/sdk/v1/session/{token}/upload.
Примечание: Принимает JPEG, PNG, WebP, MP4, MOV до 20 МБ.
ИИ обрабатывает проверку
Наши серверы параллельно выполняют определение живости, анализ подделки и сравнение лиц. Среднее время — менее 10 секунд.
Примечание: Обработка происходит полностью на стороне сервера.
Результат через polling или webhook
Опрашивайте GET /api/sdk/v1/session/{token}/status каждые 2–3 секунды. Одновременно наш сервер отправляет результат на ваш webhook URL.
Примечание: Webhook подписывается с помощью HMAC-SHA256.
Понимание результатов верификации
одобреноПроверка живости пройдена, подделка не обнаружена.
отклоненоПроверка живости не пройдена — возможная попытка спуфинга.
предупреждениеЖивость подтверждена, но подделка подозревается. Проверьте вручную.
ошибкаОшибка обработки — повторите сессию.