Подключить

API распознавания документов

Читает документы с одного снимка

Паспорт, ID-карта, миграционная карта, уведомление о прибытии, экран Амины. Giga Vision сам определяет тип, извлекает поля с оценкой уверенности и проверяет селфи с документом.

Для банков, МФО, платёжных сервисов и кадровых платформ

ПАСПОРТPASSPORT P · UTO
Фамилия / Surname
ИВАНОВ
Имя / Given names
ИВАН
Дата рождения
12.04.1990
Пол / Sex
М/M
Номер / No.
PE 1995338
Действителен до
01.08.2029
МИГРАЦИОННАЯ КАРТАMIGRATION CARD
Серия12 №3456789
  • не экран и не распечатка
  • без наложений
  • verificationPassed
11

типов документов распознаёт сервис, включая миграционный контур

7

языков интерфейса Амины / КИГИГ: RU, EN, UZ, TJ, KY, KK, HY

1

запрос на фото — тип документа и поля приходят вместе

0 ₽

за ошибки 4xx и 502 — списание только за обработанный запрос

Живое демо

Попробуйте на своём документе

Тот же API, что и в продакшене. Ответ обычно приходит за несколько секунд, иногда до двух минут.

document_type: —

Здесь появятся тип документа, извлечённые поля и уверенность по каждому.

Каталог

Поддерживаемые документы

Актуальный список — GET /v1/vision/document-types. В продакшене передавайте auto и смотрите document_type в ответе, а не то, что отправили.

01Личность

passport_photo
Загранпаспорт, страница с данными
id_card_photo
Пластиковая национальная ID-карта
identity_document_photo
Паспорт или ID; в полях дополнительно documentType
selfie_photo
Селфи с паспортом или ID в руках

Поля: ФИО (кириллица, MRZ транслитерируется), дата рождения, выдачи и окончания, пол, номер без пробелов, кем выдан, место рождения, гражданство, PINFL / IIN.

02Миграционный контур

migration_card_photo
Миграционная карта, полный кадр
migration_front_photo
Лицевая сторона миграционной карты
arrival_notification_photo
Уведомление о прибытии: фото или скрин Госуслуг
arrival_notification_doc
Уведомление о прибытии: бланк или скан
amina_photo
Экран Амина / КИГИГ на RU, EN, UZ, TJ, KY, KK, HY

Поля: серия и номер миграционки, сроки пребывания, адрес регистрации, номер и дата УОП, орган, номер КИГИГ, телефон.

03Служебные

auto
Автоопределение типа и набор полей этого типа. Рекомендуется в продакшене.
unsupported_photo
Не документ KYC: случайный экран телефона, не тот тип. Приходит rejectReason.

Экран Амины никогда не выдаётся за паспорт: даже при запросе паспорта тип станет amina_photo, а номер паспорта не будет выдуман. КИГИГ — не номер паспорта.

KYC

Документ, затем селфи с ним

HTTP 200 значит «запрос обработан», а не «человек прошёл проверку». Решение — только по verificationPassed.

  1. 01

    Документ в режиме auto

    Пользователь снимает паспорт или ID. Сервис определяет тип и возвращает поля.

  2. 02

    Берёте номер

    Сохраняете ФИО и fields.documentNumber.

  3. 03

    Селфи с этим документом

    Второй вызов: selfie_photo и expected_document_number.

  4. 04

    Решение

    KYC пройден, только если status = success и verificationPassed = true.

Почему селфи может не пройти

Коды в spoofReason через запятую, если причин несколько.

not_selfie_with_documentНет живого селфи с документом в кадре
face_mismatchЛицо не совпадает с фото в документе или сравнить нельзя
overlay_or_watermarkНаложение, водяной знак, чужой интерфейс поверх кадра
printed_or_screenФото с экрана или распечатки
expected_document_missingНе передали номер с шага паспорта
document_number_mismatchНа селфи прочитался другой номер

Как сравнивается номер

Без пробелов и регистра: pe-199 5338 = PE1995338. Расхождение в один символ на длинном номере не считается отказом.

Номер на селфи часто не читается — это нормально и не отказ. В этом случае documentNumberMatches = unread. Если ожидаемый номер — идентификатор КИГИГ, сравнение пропускается: skipped.

Как снимать

  • Документ занимает большую часть кадра, текст резкий.
  • Без блика на серии, номере и ФИО.
  • Миграционка — весь бланк или чёткая лицевая сторона.
  • Селфи — лицо и документ в одном кадре, не с экрана.
  • Повтор той же смазанной фотографии не улучшает результат.

Интеграция

Подключение за день

Отдельный REST API под документы. Ключ выдаёт поддержка, передаётся в Authorization: Bearer. Вызывайте с вашего бэкенда, не из клиентского приложения.

Базовый URL
https://airouter.host
Зеркало РФ
https://ru.airouter.host
МетодПутьКлюч
GET/v1/vision/document-typesне нужен
POST/v1/vision/recognizeобязателен
  1. Получить ключ у поддержки. Хранить его вне репозитория.
  2. Проверить GET document-types — вернётся список id.
  3. Файл → JPEG → base64 → POST recognize, таймаут 130 с, document_type: "auto".
  4. Разобрать document_type и нужные ключи fields.
  5. Пустые поля и низкая уверенность — «переснять / оператор».
  6. Логировать request_id. На 502 можно повторить.
IMG_B64=$(base64 -w 0 < ./document.jpg)

curl -sS --max-time 130 https://airouter.host/v1/vision/recognize \
  -H "Authorization: Bearer $VISION_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"document_type\": \"auto\",
    \"image_url\": \"data:image/jpeg;base64,${IMG_B64}\"
  }"
Картинка: data-URI JPEG / PNG / WebP, сырой base64 или публичный https URL. До ~10 МБ, длинная сторона до ~2560 px. Для селфи добавьте "expected_document_number".

Коды ответа

КодКогдаСписание
200Запрос обработан, в том числе status: rejectedда
400Пустой или битый image, слишком большой файл, неизвестный типнет
401Нет ключа или ключ неверныйнет
402Недостаточно средств на счётенет
403Ключ не для Vision, неактивен или отозваннет
422Тело не JSON или нет image_urlнет
502Сбой распознавания, можно повторитьнет

Следующий шаг

Подключение

Ключ доступа выдаёт поддержка Giga Vision. Перед запуском прогоняем тестовые кадры на ваших документах и настраиваем сценарий: только документ или документ и селфи.

Стоимость По согласованию Тариф, пакеты и порядок списания фиксируются в договоре.
  • Ключ доступа и базовый URL
  • Распознавание документов и проверка селфи
  • Сопровождение интеграции, разбор инцидентов по request_id
  • Списание только за обработанный запрос (HTTP 200). Ошибки 4xx и 502 не тарифицируются.

Доступ к распознаванию

Введите промокод

Промокод даёт определённое число распознаваний. Списываются только успешные — ошибки и отказы сервиса не считаются.