API распознавания документов NeuroVision принимает фото или скан, сам определяет тип документа и возвращает JSON: поля, уровень уверенности по каждому полю и результаты антифрод-проверок. Подключите REST API к бэкенду или Web SDK к сайту — в облаке в России или в своём контуре.
Один запрос — один ответ. Вашему бэкенду не нужно выбирать тип документа, вырезать поля и считать контрольные суммы: это делает сервис. Нужно сверить лицо с документом или проверить живое присутствие? Это другие шаги того же API — KYC и Liveness.
Постоянный токен создаётся в личном кабинете в разделе «Доступ», временный — запросом POST /user/login. Токен передаётся в заголовке или полем token в теле запроса.
POST /kyc/process принимает одно или несколько изображений в multipart/form-data: например, разворот паспорта и страницу с пропиской. Режим — синхронный или асинхронный.
Нейросеть находит документ на фото, определяет страну и тип, выравнивает изображение, делит его на поля и читает каждое. Параллельно идут антифрод-проверки: редактирование, фото с экрана, распечатка.
В ответе — тип документа, код страны, поля с уровнем уверенности, статусы проверок и ошибки. В асинхронном режиме результат приходит на ваш callback URL или по запросу статуса.
Обычный OCR отдаёт сплошной текст, и разбирать его приходится вашему коду. OCR API NeuroVision возвращает уже разложенные данные: каждое поле с названием, значением и уровнем уверенности модели. Поля с высокой уверенностью можно сразу записывать в анкету, CRM или АБС, а сомнительные — показать пользователю или оператору. Так сервис работает как IDP-система — подробнее на странице распознавания документов.
Итог проверки и связь результата с вашим пользователем или заявкой.
status — idle, processing, success, failed, suspicious, exception, expiredsessionId — UUID v1 (timeuuid) сессииspent — общее время обработки в секундахisClientNew — первый визит клиента или повторныйclientKey — клиентский ключ, до 36 символов; по нему ищут сессиюschemaId / scenarioId — схема (сценарий) KYC из личного кабинетаcallback URL — вебхук с финальным результатом сессииРезультат по каждому изображению — элемент results[]; меняется только набор полей документа.
type — document, selfie, facesdocName — тип документа, например Passport (2006)countryCode — страна, ISO 3166-1 alpha-3 (RUS)isBackSide — обратная сторона или нетtries — число попыток распознаванияocr.fields[]title — название поляvalue — значениеconf — уровень уверенности распознаванияПочему сессия могла не пройти, даже если поля прочитаны.
checks[] (fraud)isEdited — документ не редактированisDisplay — не сфотографирован с экранаisPrinted — документ напечатан, не фото экранаisXerocopy — не ксерокопияisMRZValid — MRZ-зона валиднаisFieldsModified, isStampsOk, isCropped и другие — у каждой проверки status и captionerrors[] — например [document] unknown document typeimageObjects[] — распознанные объекты: штампы, подписиТип документа сервис определяет сам. От интеграции нужно только одно — передать читаемое изображение в правильном формате.
Паспорта, ID-карты, водительские удостоверения, виды на жительство 195+ стран и территорий: кириллица, латиница и другие письменности.
Разворот паспорта и страницу с пропиской можно отправить в одном запросе или отдельными шагами сценария: сервис объединит данные в одной сессии.
Страну и тип указывать не нужно: модель классифицирует документ по изображению. Для очень похожих документов тип можно задать в сценарии.
Сервис принимает только JPEG и PNG. HEIC, WEBP и PDF отклоняются с ошибкой [general] bad image — конвертируйте их на своей стороне до отправки.
Лицо — от 30×30 пикселей. Без бликов, сильного сжатия и обрезанных краёв: документ должен быть в кадре целиком.
По умолчанию антифрод отмечает распечатки, ксерокопии и фото с экрана. Если в процессе нужны сканы, эти проверки отключаются в редакторе сценария.
Web SDK — готовый JavaScript-виджет. Он открывается поверх вашей страницы, просит доступ к камере, подсказывает, как снять документ, и сам отправляет снимки в API: инструкция → съёмка в рамке → проверка качества с подсказкой → завершение. Итог приходит вебхуком на ваш бэкенд; колбэк successCb на фронтенде срабатывает только при успешном итоге.
Мобильное приложение: WebView вместо нативного SDK. Отдельных библиотек для iOS и Android сейчас нет. Виджет адаптивный и работает с камерой смартфона, поэтому в мобильном приложении его открывают во встроенном браузере или WebView. Ограничение: внутри cross-origin iframe браузер блокирует камеру, поэтому виджет нельзя вкладывать в чужой iframe.
clientKey шифруется на вашем сервере ключом сценария (пример — AES-256-CBC на Node.js в документации) и только потом передаётся в браузер: работа с clientKey, параметры виджета. Оформление: светлая или тёмная тема (theme), «матовое стекло» поверх страницы (blurHost), встраивание внутрь блока (mountElementId), колбэки successCb, closeCb, finalizedCb, «липкая» сессия на 15 минут (stickySession), выбор языка. Без интеграции — прямая ссылка на виджет или одноразовые KYC-ссылки из личного кабинета, до 1 000 штук за раз.
Облако — изображения обрабатываются на серверах NeuroVision в России, запуск после выдачи токена и настройки сценария, масштабирование на стороне NeuroVision. В вашем контуре (on‑premises) — на ваших серверах, без выхода во внешние сервисы; Docker-контейнеры на ваши серверы устанавливают инженеры NeuroVision; масштабирование — ваши серверы, для продуктива два сервера с балансировщиком.
Облако — интернет нужен для запросов к API, модели обновляются автоматически, без вашего участия. В вашем контуре — интернет не нужен для работы, нужен для активации лицензии и обновлений, их можно ставить офлайн-пакетами; модели обновляются по согласованию: инженеры NeuroVision подключаются по защищённому каналу и тестируют после обновления.
Облако — оплата за распознанные документы или пакетами; подходит онлайн-сервисам, финтеху и маркетплейсам, которым нужен быстрый запуск. В вашем контуре — лицензия; подходит банкам, госкомпаниям, медицине и всем, у кого изолированный контур.
Ядро одно и то же — меняется место, где работает сервис, и кто его обслуживает. Облачный OCR-сервис NeuroVision подходит для быстрого старта, установка в контуре — когда документы не должны покидать периметр. Функции API в обоих вариантах одинаковые: тот же метод, тот же JSON.
CPU от 16 потоков с AVX2 (AMD Ryzen 9 3900X или аналог), NVIDIA RTX 3090 24 ГБ или аналог (A5000, RTX 4080), ОЗУ 64 ГБ, SSD от 1 ТБ.
CPU от 24 потоков (Intel Core i9-12900KF или аналог), 2× RTX 3090 (48 ГБ) или аналог (2× A5000, A6000, RTX 4090), ОЗУ 128 ГБ, SSD/NVMe от 2 ТБ, сеть от 1 Гбит/с.
Вы готовите серверы и доступ по SSH или защищённому каналу, инженеры NeuroVision ставят контейнеры и проверяют работу. Обновления — по согласованию: новая версия включается только после тестов.
Изображения и результаты не покидают периметр.
Интернет нужен только для активации лицензии и обновлений.
Проверьте их на своих документах и нагрузке. Как измерять качество OCR — в статье о точности AI OCR
Время обработки
На production-серверах полная проверка документа — загрузка, распознавание, извлечение полей и проверки — в среднем 500–600 мс, на демо-стенде — до 5 секунд. Фактическое время сессии — в поле spent.
Синхронный и асинхронный режим
mode=sync — результат в том же HTTP-ответе, удобно для анкеты. mode=async — сразу sessionId, результат — вебхуком или запросом POST /kyc/session/status. В примерах документации таймаут клиента — 30 и 120 секунд.
Лимиты и пакеты
По тарифу нет ограничений частоты запросов: пакет можно израсходовать за день или за год. Закончился пакет — сервис не блокируется, нужно докупить следующий. Нагрузку обсуждаем на старте теста.
Сколько хранятся данные
Результаты доступны по sessionId через API и в личном кабинете, срок задаётся в сценарии. Оригиналы изображений хранятся 6 месяцев и удаляются. В контуре сроки определяете вы.
Облако NeuroVision работает на серверах в России
По 152‑ФЗ запись, хранение и извлечение персональных данных граждан РФ с использованием баз данных за пределами России не допускаются (ч. 5 ст. 18). Облачный OCR API это требование не нарушает, а при установке в контуре данные остаются у вас.
Каждый запрос — с токеном
Временный JWT задаётся со сроком действия, постоянные токены создаются в личном кабинете бессрочными или с датой окончания, а права определяются ролью пользователя. Токены хранятся как секреты и не передаются в браузер.
clientKey и вебхуки шифруются
clientKey для браузера шифруется ключом сценария (AES-256-CBC в примере документации). Тело вебхука можно шифровать секретным ключом, а персональные данные — не отправлять вовсе, только статусы.
Вы решаете, сколько хранить
Срок хранения результатов настраивается в сценарии, оригиналы изображений удаляются через 6 месяцев. Отчёты и выгрузки — в личном кабинете.
Без интернета
В варианте on-premises изображения и результаты обрабатываются и хранятся только на ваших серверах.
152‑ФЗ
российский разработчик, ПО в реестре № 19972
[general] bad image — переданный файл не является изображением [general] too small image — изображение слишком маленькое для распознавания [general] no documents on image — на изображении не найдены документы [document] text fields not visible — поля не видны [fraud] mobile device — фото сделано с экрана мобильного устройства invalid schema (неверные параметры или нет изображения), 401 access denied, 403 invalid user credentials. Ошибка распознавания приходит в обычном ответе: status: failed и причина в results[].errors в формате [группа] описание. failed не всегда значит «не прочитали»: поля могут быть распознаны, но сессия не пройдёт из-за низкой уверенности или антифрод-проверки. Смотрите errors и checks в каждом элементе results. От заявки до первого JSON. Разработчику понадобится один вечер, остальное — организационные шаги на нашей стороне.
Оставьте заявку — менеджер выдаст доступ к личному кабинету. Тестовый доступ — 1 месяц.
В личном кабинете откройте раздел «Доступ» (Access Tokens), создайте токен (при необходимости укажите дату окончания). Сохраните его как секрет.
В разделе «KYC/AML» создайте сценарий: какие документы и страны принимать, какие проверки включать, callback URL для вебхуков. Скопируйте его идентификатор.
Выполните запрос POST /kyc/process по документации метода с вашим токеном и сценарием. Для первого раза хватит одного фото документа. Сначала посмотреть, как это работает, можно в демо.
Запишите поля в свою систему, обработайте failed и низкую уверенность. Для продуктива включите асинхронный режим и вебхук с шифрованием.
Платите только за распознанные документы: поштучно или пакетами, без ограничений по скорости расхода. Первый месяц — бесплатный тест.
Рассчитать стоимость
Проект «Разработка мультимодальной системы с применением искусственного интеллекта "Neuromed" для управления диагностическими процессами клиники на базе платформы компьютерного зрения "Нейровижн"» поддержан Фондом содействия инновациям в рамках реализации федерального проекта «Отечественные решения»
Платформа компьютерного зрения Нейровижн зарегистрирована в Роспатенте (свидетельство №2023661508) и включена в Реестр российского ПО (реестровая запись №19972 от 13.11.2023)
Право использовать Платформу предоставляются в соответствии с лицензионным договором, заключаемым Нейровижн с клиентами
Расскажите, какие документы и в каком объёме нужно распознавать и где должен работать сервис — в облаке или в вашем контуре. Выдадим доступ к личному кабинету и поможем с первым запросом.
Не можете сформулировать запрос? Запишитесь на звонок, и наша команда свяжется с вами в удобное время
Записаться на звонокКомпания внесена в реестр IT-компаний и реестр операторов персональных данных Минцифры России.
Адрес: Москва, Пресненская наб., д. 12 — деловой центр «Москва-Сити», башня «Федерация». Ближайшие станции метро — «Деловой центр» и «Международная».
Как повысить качество распознавания и выстроить безопасную интеграцию — в нашем блоге.
Ответы о методах, SDK, развёртывании в Docker, форматах, скорости, данных и тестовом доступе
Это REST API, который принимает изображение документа и возвращает распознанные поля в JSON. Сервис сам определяет страну и тип документа, читает поля, проверяет изображение на редактирование и фото с экрана и указывает уровень уверенности по каждому полю.
POST /kyc/process по адресу https://api.neuro-vision.ru/v1/. В запросе — токен, одно или несколько изображений в поле images и идентификатор сценария. Статус асинхронной сессии запрашивается методом POST /kyc/session/status.
Отдельных серверных библиотек нет: API работает по обычному HTTP, поэтому подходит любой язык. В документации есть готовые скрипты на Python.
Нативных SDK для Android и iOS сейчас нет. Web SDK работает в мобильных браузерах и открывается внутри приложения через WebView, поэтому съёмку документа можно встроить и в мобильное приложение.
Да. Сервис устанавливается в вашем контуре как набор Docker-контейнеров, установку и обновления выполняют инженеры NeuroVision. После установки он работает без интернета: доступ нужен только для активации лицензии и обновлений.
Минимальная конфигурация из документации — CPU от 16 потоков с AVX2, NVIDIA RTX 3090 с 24 ГБ видеопамяти или аналог, 64 ГБ ОЗУ и SSD от 1 ТБ. Для продуктива с высоким SLA рекомендуются два сервера с балансировщиком нагрузки.
Только JPEG и PNG. Файлы HEIC, WEBP и PDF отклоняются с ошибкой [general] bad image, поэтому их нужно конвертировать до отправки.
По документации на production-серверах полная проверка документа занимает в среднем 500–600 мс, на демо-стенде — до 5 секунд. Фактическое время каждой сессии возвращается в поле spent.
По тарифу ограничений частоты нет: пакет можно израсходовать в любом темпе, а после его окончания сервис не блокируется. Ожидаемую нагрузку обсуждаем на старте тестового доступа.
В облаке — на серверах NeuroVision в России, при установке в контуре — только на ваших серверах. Срок хранения результатов настраивается в сценарии, изображения удаляются через 6 месяцев, а вебхуки можно отправлять без персональных данных.
Да, тестовый доступ даём на 1 месяц с личным кабинетом, токеном и документацией. Оставьте заявку внизу страницы.
Обычный OCR возвращает сплошной текст, и разбирать его приходится вам. OCR API NeuroVision возвращает поля с названиями и уровнем уверенности, тип и страну документа и результаты антифрод-проверок изображения.
