Veryfi OCR API: возможности, форматы, цены и интеграция

Veryfi OCR API — не программа для открытия PDF и не мобильный сканер, а облачная платформа Veryfi, Inc. для распознавания и структурированного извлечения данных из документов. Её сильная сторона — не просто вернуть сплошной OCR-текст, а разложить содержимое чека, счёта, банковского или налогового документа по полям JSON: поставщик, даты, суммы, налоги, позиции, валюта и другие сущности. Поэтому продукт следует оценивать как серверный компонент для бухгалтерских, финтех-, AP/AR-, loyalty- и документооборотных систем, а не как замену настольному PDF-просмотрщику.

Скачать Veryfi OCR API

У Veryfi OCR API нет установочного файла в привычном смысле. Сам сервис работает на стороне Veryfi, поэтому безопасный путь начинается с официального сайта разработчика: регистрация API-аккаунта, получение учётных данных в портале и работа через REST v8 либо через один из официальных SDK. Загружать «Veryfi OCR API installer» с каталогов программ не требуется и не следует: такой пакет не является способом поставки самого облачного OCR-сервиса.

Для прямой интеграции достаточно HTTPS-клиента, который умеет передавать заголовки авторизации и файл либо ссылку на файл. Официальный каталог SDK охватывает Python, Java, Node.js, PHP, Go, Dart, C#, Ruby, Rust, Swift, Kotlin и Android. SDK — это клиентские обёртки над API, а не отдельные OCR-движки. Отдельно существует Veryfi Lens: это SDK захвата документа камерой для мобильных и браузерных приложений; он улучшает этап съёмки, но не заменяет OCR API и продаётся как отдельное дополнение.

Публичная документация доступна без аккаунта, а выполнение реальных вызовов требует регистрации. На продуктовых страницах Veryfi указывает 14-дневный бесплатный пробный период без банковской карты, а актуальная страница тарифов одновременно содержит план Free с объёмом до 100 документов в месяц. Перед запуском производственной интеграции разумно сверить конкретный режим своего аккаунта в Billing, поскольку trial и тарифный Free — разные элементы публичного онбординга.

Что такое Veryfi OCR API

Veryfi OCR API — действующая облачная платформа Veryfi, Inc. для превращения неструктурированных документов в машинно-обрабатываемые данные. В актуальных материалах используются и более широкие названия Document Intelligence и Data Extraction APIs, но OCR API остаётся в документации, ценах и SDK. Практически это семейство специализированных API, а не один универсальный метод для любого файла.

У платформы есть специализированные направления для чеков и инвойсов, банковских чеков и выписок, форм W-2/W-9, визитных карточек и других типов документов. Для менее стандартных структур предусмотрен AnyDocs/∀Docs. Такое разделение важно: схема ответа, набор полей, допустимые форматы, лимиты и тарификация могут различаться по endpoint. Нельзя переносить ограничение или список форматов одного API на все остальные.

Veryfi OCR API не следует смешивать с Veryfi Expense Management. Последний — отдельный SaaS-продукт для работы с расходами через веб и мобильные клиенты; справочный центр прямо отделяет его тарифы от OCR API. Не следует смешивать API и с Veryfi Lens: Lens отвечает за захват изображения в приложении, тогда как OCR API выполняет серверное распознавание и извлечение. Официальные Python, C#, Java и другие SDK также не являются отдельными редакциями Veryfi OCR — это способы обращаться к той же облачной платформе из конкретного языка.

Основные функции Veryfi OCR API

OCR плюс структурированное извлечение

Ключевое отличие от простого OCR заключается в целевом JSON. Для чеков и счетов Veryfi возвращает распознанные значения в предопределённых полях и может включать OCR-текст документа. В ответе для этого класса документов предусмотрен широкий набор структурированных полей. Это позволяет приложению работать не со строкой «как увидел распознаватель», а с конкретными сущностями: общей суммой, валютой, датой, поставщиком, налогами и массивом line_items.

Позиции, поля и контроль уверенности

Для финансовых документов важна работа с позициями, а не только с итогом. В ответах для чеков и инвойсов присутствует массив line_items, а API умеет возвращать дополнительные сведения о доверии к распознанным значениям. Параметр confidence_details позволяет запрашивать оценки для полей; bounding boxes дают привязку данных к областям документа там, где это поддержано соответствующим endpoint. Эти признаки нужны для построения очереди ручной проверки: бизнес-логика может направлять сомнительные значения оператору, вместо того чтобы одинаково доверять каждому полю.

Предварительная обработка и сигналы качества

Платформа описывает многоступенчатую обработку изображения: анализ размытия и качества, выравнивание, обрезку границ документа, распознавание текста, штрихкодов и QR-кодов, а затем извлечение сущностей. Для интегратора практический эффект состоит в том, что часть типичных задач «до OCR» выполняется сервисом. Но это не отменяет требований к исходнику: качество и ясность изображения прямо влияют на точность, а чрезмерное сжатие или низкое разрешение ухудшают распознавание.

Несколько способов передачи документа

Документ можно отправить как multipart/form-data, как Base64 либо передать публично доступный file_url. Для набора файлов одного документа поддерживается ZIP. Актуальный справочный материал Veryfi отмечает, что URL обычно удобен для файлов, уже находящихся в объектном хранилище или CDN; бинарная загрузка подходит для локального файла на сервере; Base64 функционален, но менее эффективен по объёму передачи.

Синхронный и асинхронный режим

По умолчанию обработка синхронная: запрос ждёт завершения и получает извлечённые данные в ответе. Для массовых очередей есть async-режим. В нём API быстро возвращает идентификатор задания, а после обработки отправляет событие на заранее подтверждённый HTTPS-webhook. Затем приложение может получить итоговый документ по его ID. Это делает Veryfi пригодным как для интерактивной операции «загрузил — получил JSON», так и для фоновой обработки очереди.

Разделение многостраничных PDF

Обычный endpoint для чеков и счетов рассматривает вход как один документ. Если один PDF содержит несколько независимых чеков или инвойсов, предназначен PDF Splitter: он принимает PDF или ZIP, разделяет набор и завершает работу асинхронно. Для этого endpoint в документации указан максимальный PDF 50 МБ. Это отдельный сценарий и отдельный маршрут, поэтому его ограничения нельзя автоматически переносить на обычный POST документов.

Интерфейс и удобство использования

Основной интерфейс разработчика — REST API и документация, однако Veryfi дополняет их веб-порталом. Актуальный Getting Started описывает портал как центральную зону, где видны обработанные документы, результаты извлечения, использование API, участники команды и настройки. В Inbox можно просмотреть поданный документ и структурированные поля, что существенно упрощает диагностику по сравнению с API, который оставляет разработчика только с сырым JSON.

Для знакомства без Postman предусмотрен Interactive API Explorer. Он показывает endpoint, параметры запроса, схему и пример ответа, а после авторизации позволяет выполнить реальный вызов и увидеть JSON. Это снижает порог входа: сначала можно проверить структуру запроса в браузере, а затем перенести тот же вызов в серверный код или SDK. Английские названия полей и примеры в официальной документации остаются базовой терминологией интеграции.

Русский язык подтверждён для распознаваемых документов. Это не означает русскую локализацию портала: официальные примеры интерфейса и имена JSON-полей англоязычны, а отдельное обещание русифицированного веб-интерфейса не опубликовано.

Поддерживаемые форматы и совместимость

Для Receipts & Invoices endpoint актуальная справка перечисляет JPG/JPEG, PNG, GIF, WebP, AVIF, BMP, HEIC/HEIF, PDF, ZIP, TXT, HTML/HTM, EML, OFD, RTF, ODT, DOC/DOCX, XLS/XLSX и CSV. Но часть дополнительных типов может быть отключена для конкретного клиента и включаться через поддержку. Веб-загрузчик портала принимает более узкий набор: JPG/JPEG, PNG, PDF, HEIC и HEIF. Поэтому файл, который не удаётся перетащить в браузерный uploader, ещё может быть допустим через REST endpoint.

Для основного endpoint чеков и счетов публичная справка указывает размер от 0,25 КБ до 20 МБ и максимум 15 страниц за один вызов, с возможностью обсуждать увеличение лимита с поддержкой. Для Checks, W-9, W-2 и других специализированных API список форматов уже; например, типичные endpoint этого класса принимают в основном изображения, PDF и ZIP. Перед массовой миграцией необходимо проверять именно reference нужного endpoint, а не общий маркетинговый список.

Выход интеграции — JSON. Это принципиально отличается от конвертера PDF→DOCX: Veryfi не позиционируется как редактор верстки и не обещает восстановить визуальную структуру документа в Word. В ответе могут присутствовать ссылки на представление исходника или PDF, OCR-текст, структурированные поля и метаданные, но основная ценность — схема данных, которую дальше потребляет ваше приложение.

Производительность и стабильность

Для интерактивного запроса синхронный режим проще: ответ приходит в том же HTTP-сеансе. Для пакетной нагрузки асинхронная модель устойчивее, потому что приложение не держит большое количество долгих соединений и получает событие webhook после завершения. Документация отдельно предупреждает, что доставка webhook не должна рассматриваться как «ровно один раз», поэтому получатель обязан быть идемпотентным и уметь безопасно обрабатывать повторное событие.

У обычного Process a Document есть практические границы: 20 МБ и 15 страниц по текущей reference для Receipts & Invoices. Для PDF, внутри которого несколько самостоятельных документов, лучше применять специальный Splitter с пределом 50 МБ, а не пытаться сделать один гигантский синхронный запрос. Такой выбор одновременно уменьшает риск тайм-аута и даёт отдельные document ID для последующей обработки.

Reference Process a Document также описывает редкий, но важный сценарий: запрос, который длится дольше 120 секунд, может завершиться 504 на балансировщике, хотя загрузка на стороне Veryfi фактически продолжилась и может быть учтена как обработанная. Для безопасного повтора предусмотрен Idempotency-Key: повтор с тем же ключом возвращает исходный документ вместо создания дубля. Для платной API-интеграции это критично, потому что простой автоматический retry без идемпотентности способен породить двойную транзакцию.

Лимит запросов также зависит от endpoint. Текущая справка по форматам для Receipts & Invoices и AnyDocs указывает 60 запросов в секунду, а для ряда специализированных API — 20. Производственную систему следует строить с обработкой HTTP 429 и backoff независимо от опубликованной цифры: тариф, endpoint и индивидуальные условия могут задавать более низкий фактический предел.

Лицензирование и версии

Veryfi OCR API — проприетарный облачный сервис с транзакционной тарификацией, а не бессрочная локальная лицензия. Актуальная публичная страница Pricing делит предложение на Free, Starter и Growth. Для Receipts и Invoices Free предусматривает до 100 документов в месяц. Starter указывает 0,08 доллара за чек и 0,16 доллара за инвойс/документ при минимальном месячном платеже 500 долларов; Growth рассчитан на объёмные договорные условия и скидки. Для отдельных типов документов и дополнений цена может быть индивидуальной.

Ключевая особенность тарификации Veryfi — расчёт по документу, а не по странице, что может быть выгодно для многостраничного инвойса в пределах разрешённых лимитов. Однако это не делает цену автоматически ниже конкурентов: у сервисов с оплатой за страницу стоимость зависит от средней длины документа, а у Veryfi — от числа документов и их типа. Сравнивать нужно на собственном распределении: например, 10 000 одностраничных чеков и 10 000 десятистраничных счетов дают совершенно разный профиль стоимости у разных поставщиков.

Актуальная документация ориентируется на API v8. В старых руководствах и скриншотах можно увидеть v7, но новую интеграцию разумно строить на v8 и сверять endpoint с нынешней reference. В аутентификации похожая ситуация: Standard API keys остаются поддерживаемым legacy-механизмом, а документация рекомендует новые Bearer keys, включая scoped-вариант для ограничения доступных маршрутов.

Системные требования

Прямой REST API

Минимальные требования к ОС разработчик не задаёт, потому что OCR выполняется в облаке. Клиентская среда должна уметь устанавливать защищённое HTTPS-соединение, передавать UTF-8 и нужные HTTP-заголовки, а также иметь сетевой доступ к Veryfi. Для новых интеграций документация рекомендует Bearer API keys; каждый запрос использует CLIENT-ID и Authorization. Standard API keys в формате username/API key остаются поддерживаемыми для совместимости.

Официальные SDK

Veryfi публикует SDK для Python, Java, Node.js, PHP, Go, Dart, C#, Ruby, Rust, Swift, Kotlin и Android. Общая страница SDK не задаёт единый минимальный номер runtime для всех библиотек, поэтому системное требование конкретного проекта следует брать из репозитория выбранного SDK. Это важнее, чем пытаться сформулировать несуществующее универсальное требование «Windows 10 и 4 ГБ RAM» для облачного API.

Веб-портал

Отдельные минимальные версии браузеров и аппаратные требования для веб-портала в актуальной документации не опубликованы.

Требования к входным данным

Технические пределы файла важнее характеристик компьютера. Для Receipts & Invoices ориентир — до 20 МБ и до 15 страниц в обычном запросе; список форматов приведён выше. Для универсального или специализированного API ограничения могут отличаться, поэтому валидация файла должна учитывать endpoint ещё до отправки, чтобы не тратить запросы на заведомо недопустимый вход.

Карта критических зависимостей

Главная архитектурная зависимость — облако Veryfi. В отличие от локального OCR, здесь нельзя продолжить распознавание полностью офлайн. Зато локальная машина освобождена от вычисления модели, а обновления выполняются на стороне сервиса. Для критического документооборота эту развилку нужно принять осознанно: облачная простота эксплуатации обменивается на сетевую и контрактную зависимость от поставщика.

Паспорт обратимости операций

Отправка документа. Она обратима на уровне данных: обработанную запись можно удалить через API, а auto_delete позволяет не оставлять документ после получения результата. Но сам факт уже выполненной транзакции и возможное начисление стоимости не «отменяются» удалением. Поэтому тестовую среду, фильтр дублей и Idempotency-Key следует рассматривать как финансовые, а не только технические меры.

Извлечённый JSON. Это хорошо переносимый результат: его можно сохранить в собственной базе, преобразовать в CSV, отправить в ERP или заново обработать собственной логикой без доступа к интерфейсу Veryfi. Наиболее безопасная стратегия — хранить рядом идентификатор исходного документа, версию собственной схемы и необработанный ответ, если внутренние правила безопасности разрешают такую ретенцию.

Ротация ключей. Она обратима только организационно: старый секрет после отзыва больше не должен использоваться. Поэтому ключ меняют по этапам — создать новый, обновить потребителей, проверить рабочий вызов и лишь затем отключить старый. Для нескольких интеграций scoped Bearer keys уменьшают радиус отказа: компрометация или отзыв одного ключа не обязаны давать доступ ко всем маршрутам.

Преимущества и недостатки Veryfi OCR API

Плюсы и минусы

Структурированный результат, а не только OCR. Для финансовых документов API возвращает готовые поля и line items, сокращая объём постобработки.

Специализированные модели. Чеки, счета, банковские и налоговые документы имеют отдельные endpoint и схемы.

Несколько способов загрузки. Multipart, URL, Base64 и ZIP покрывают серверные и мобильные сценарии.

Синхронная и асинхронная архитектура. Можно выбирать между немедленным ответом и webhook-потоком для очередей.

Интерактивная документация и портал. JSON можно сопоставлять с исходником без написания отдельной диагностической панели.

Контроль хранения. Доступно удаление через API и auto_delete для сценариев с минимальной ретенцией.

Безопасность уровня enterprise. Veryfi заявляет SOC 2 Type II, GDPR, CCPA и HIPAA; транспорт защищается TLS, а данные — шифрованием.

Минусы

Облачная зависимость. Полноценного локального OCR-режима без сети нет.

Это API, а не настольное приложение. Для разового распознавания пользователю без разработки проще выбрать GUI-инструмент.

Лимиты зависят от endpoint. Формат, число страниц, размер и rate limit нельзя считать едиными для всей платформы.

Минимальный платёж Starter. Публично указанные 500 долларов в месяц могут быть непропорциональны небольшому production-проекту после бесплатного диапазона.

Нужно проектировать надёжность самостоятельно. Webhook может повториться, сеть может дать 504, а приложение обязано корректно реализовать retry, идемпотентность и контроль ошибок.

Confidence не равен гарантии. Для критичных реквизитов всё равно требуется бизнес-валидация.

Сравнение с аналогами

С Sumatra PDF сравнение корректно только как граница классов: Sumatra — локальный просмотрщик, Veryfi — серверное распознавание и извлечение данных. Они могут дополнять друг друга: API извлекает JSON, а пользователь открывает оригинал в просмотрщике.

Если задача не требует API и сводится к локальному OCR и работе с PDF, полезнее смотреть на настольные инструменты. На sumatra-pdf.com есть отдельный обзор ABBYY FineReader. Для редактирования PDF вместо серверного извлечения данных уместны Adobe Acrobat Pro и PDF-XChange Editor. Это не прямые API-конкуренты Veryfi, а другой класс инструмента.

Инструкция по установке

Облачный API не устанавливается как десктопная программа; ниже описано подключение к актуальной линии v8.

Создайте API-аккаунт через официальный сайт Veryfi и войдите в веб-портал.

Откройте Settings → Keys. Для новой интеграции отдайте предпочтение Bearer API key, если он доступен вашему аккаунту; ограничьте scoped key только нужными маршрутами. Legacy Standard key используйте прежде всего для существующей совместимости.

Сохраните CLIENT-ID и секрет авторизации в секрет-хранилище приложения. Не помещайте рабочие ключи в публичный репозиторий, HTML страницы или клиентский JavaScript.

Выберите нужный endpoint по типу документа. Для чеков и счетов базовая линия v8 использует маршрут documents; не подменяйте его endpoint банковских чеков или налоговых форм.

В Interactive API Explorer выполните тест на заведомо безопасном небоевом документе. Проверьте HTTP 200, document ID, JSON и соответствие основных сумм оригиналу.

Перенесите вызов в серверный код или официальный SDK. В production добавьте тайм-ауты, обработку 4xx/5xx, Idempotency-Key для повторяемых загрузок и журнал correlation/document ID.

Если нужен async, зарегистрируйте публичный HTTPS-webhook, проверьте его подтверждение и сделайте обработчик повторных событий идемпотентным.

До запуска определите retention: хранить документы в Veryfi, удалять позже через API или использовать auto_delete сразу после извлечения.

Безопасное отключение

Если интеграция больше не нужна, сначала выгрузите необходимые JSON и исходные документы в собственное хранилище. Затем остановите отправку новых файлов, отключите webhook и отзовите ключ, который использовала интеграция. Для бесплатного или trial-аккаунта удаление аккаунта выполняется через настройки профиля; перед этим нужно исходить из того, что связанные данные будут удалены. Для платного аккаунта порядок прекращения подписки следует выполнять через Billing и только после резервного копирования необходимой информации.

Практические кейсы

Чек из мобильного приложения → расход в учётной системе

Цель. Получить из фотографии чека дату, поставщика, валюту, итог и позиции. Подготовка. Приложение сохраняет качественный JPG/HEIC, backend получает файл и не раскрывает API-secret мобильному клиенту. Шаги. Backend отправляет документ в Receipts/Invoices endpoint, просит confidence details для критичных полей, записывает document ID и JSON. Проверка. Сумма line_items сопоставляется с total, валюта — с допустимой для аккаунта, низкий confidence направляет запись на ручную проверку. Ограничение. Даже высокий score не заменяет бухгалтерскую валидацию.

PDF с несколькими документами → отдельные записи

Цель. Разделить пакет, где один PDF содержит несколько чеков или счетов. Подготовка. Убедитесь, что файл укладывается в 50 МБ лимита PDF Splitter и настройте webhook. Шаги. Отправьте PDF в documents-set, дождитесь callback, получите идентификаторы созданных документов и затем извлеките каждый JSON отдельно. Проверка. Количество дочерних документов сравните с ожидаемым числом логических документов в пакете. Ограничение. Splitter — отдельный endpoint и асинхронный поток; его нельзя считать обычным синхронным Process a Document.

Документ с минимальной ретенцией

Цель. Получить данные, не оставляя исходный документ в облачном аккаунте дольше обработки. Подготовка. Собственная система должна быть готова сохранить необходимый JSON до удаления. Шаги. Передайте auto_delete в запросе там, где параметр поддерживается, обработайте возвращённый JSON и сохраните только разрешённый внутренней политикой набор полей. Проверка. Система должна не зависеть от последующего GET документа после удаления. Ограничение. Немедленное удаление ухудшает возможности последующего аудита через портал; оригинал нужно хранить отдельно, если этого требует процесс.

Навигатор по сбоям

Диагностика должна начинаться с класса ошибки. Пересылать один и тот же документ снова при любом исключении — худшая универсальная стратегия: она не исправит 401 или 403, может усилить 429 и способна породить оплачиваемый дубль после 504. Безопасный клиент различает «исправить запрос», «подождать», «повторить с тем же idempotency key» и «передать человеку».

Часто задаваемые вопросы

Можно ли использовать Veryfi OCR API без программирования?

Для первичной проверки — да: в портале есть загрузка документов и Interactive API Explorer. Но полноценная автоматизация предназначена для интеграции через REST или SDK. Если нужен постоянный ручной OCR одного файла за другим, настольная программа обычно проще.

Работает ли Veryfi с русским языком?

Да, русский присутствует в официальном перечне поддерживаемых языков OCR. Это относится к содержимому документа. Из этого не следует наличие русской локализации API-портала.

Можно ли отправить DOCX, XLSX или CSV?

Для Receipts & Invoices текущая справка перечисляет DOC/DOCX, XLS/XLSX и CSV наряду с изображениями и PDF, но подчёркивает, что отдельные типы могут быть не включены для конкретного клиента. Для другого endpoint список нужно проверять отдельно.

Что возвращает API: PDF или текст?

Основной программный результат — JSON со структурированными данными и OCR-текстом. Это не конвертация в редактируемый Word. Сервис может хранить и предоставлять представления исходного документа, но логика интеграции строится вокруг JSON-контракта.

Можно ли хранить документ только у себя?

Можно минимизировать облачную ретенцию. Veryfi предоставляет удаление через API и параметр auto_delete для удаления записи после обработки. Если документ нужен для аудита, собственное защищённое хранилище следует подготовить до включения автоматического удаления.

Что выбрать для обычного редактирования PDF?

Если цель — менять текст, страницы, аннотации или форму документа вручную, нужен PDF-редактор, а не OCR API. Для офлайн-инструментов можно отдельно изучить PDF24 Creator; он относится к другому классу программ и не является заменой серверному data extraction pipeline.

Как защититься от двойной оплаты при сетевом сбое?

Для загрузок, которые могут быть повторены после тайм-аута, используйте Idempotency-Key и повторяйте тот же ключ для того же логического документа. Это особенно важно при 504, когда клиент не получил ответ, но сервер мог завершить обработку.

Вывод

Veryfi OCR API подходит разработчикам и компаниям, которым нужно автоматически получать из чеков, инвойсов и других бизнес-документов структурированный JSON, а не просто распознанный текст. Его сильная комбинация — специализированные модели, line items, confidence signals, несколько способов загрузки, async/webhooks и управляемая ретенция. Для такой задачи облачный API логичнее настольного OCR, потому что результат сразу готов к передаче в backend, ERP или аналитический pipeline.

Если инфраструктура уже глубоко построена на AWS, Google Cloud или Azure, их document intelligence сервисы могут дать более естественную интеграцию с существующими IAM, очередями и хранилищами. Если же приоритет — готовое извлечение финансовых документов по предсказуемым схемам и оплата за документ, Veryfi заслуживает отдельного пилота на реальном корпусе. С Sumatra PDF его правильнее использовать не «вместо», а рядом: Sumatra остаётся средством просмотра, Veryfi — машинным слоем распознавания и структурирования.