Dbrain
Ask or search…
K
Comment on page

Базовый OCR

Возвращаем весь найденный текст из любых изображений документов
Рассказываем про сервис, чтобы вы понимали его возможности. Воспользоваться им пока что нельзя.
«Базовый OCR» подойдёт для случаев, когда вам не нужны структурированные данные из документа, а нужно просто извлечь весь текст. Сервис поможет, когда нужно организовать поиск по большому массиву данных, например по книге.
Если вам нужны структурированные данные из документа, воспользуйтесь сервисом «Извлечение данных».
Чтобы воспользоваться сервисом, отправьте POST-запрос на URL https://latest.dbrain.io/basic_ocr

Параметры запроса к API

Асинхронный запрос

async — boolean
Поведение по умолчанию: async=false — сервис обрабатывает запросы синхронно. При отправке запроса вы получите ответ только после окончательного завершения обработки запроса сервисом.
Если вам нужен асинхронный режим, укажите в запросе async=true. В таком случае в ответ на запрос сервис вернёт в response body параметр task_id, например:
"task_id": "96b8ccc950a70699927036842c624d7c"
Используйте этот task_id, чтобы получить результаты классификации в методе result:
curl -X 'GET' \
'https://latest.dbrain.io/result/96b8ccc950a70699927036842c624d7c?token=XXX' \
-H 'accept: application/json'
Не забудьте указать в параметре token ваш ключ лицензии. Рекомендуем запрашивать метод result в цикле с периодом 1-2 секунды.

Возврат изображений

return_crops — boolean
  • Поведение по умолчанию: false — сервис не возвращает изображения найденных слов
  • true — сервис возвращает изображения найденных слов

Тегирование запроса

task_tags — string array
Поведение по умолчанию: параметр не используется.
Функция тегирует запросы по вашему усмотрению. Это упрощает отслеживание пакетов документов, связанных с конкретным клиентом. Для использования функции, укажите в параметре task_tags удобный вам тег: task_tags=тэг

Движок извлечения текста

engine — string

  • Поведение по умолчанию: i — основной движок извлечения текста, работает в локальных версиях сервиса. Мы не рекомендуем менять этот параметр без прямого указания от нашей службы поддержки.
  • g — второй альтернативный движок извлечения текста, работает только в облачной версии решения.

Рукописный текст

handwritten — boolean
  • Поведение по умолчанию: false — сервис ожидает документ, в котором содержится только печатный текст
  • true — сервис ожидает документ, в котором содержатся рукописные символы

Язык извлечения текста

language — string
  • Поведение по умолчанию: rus — русский язык.
  • eng — английский язык.
  • any — смесь русского, английского и других языков.

Тело запроса к API

Изображение

image — string ($binary)
Обязательно для передачи в запросе. Сервис ожидает изображение в двоичном виде.
Перед началом работы с сервисами советуем заглянуть в раздел «Общая информация о сервисах». В нём перечислили форматы файлов, которые поддерживают сервисы, описали общие для всех сервисов параметры API и расшифровали коды ошибок.

В ответе на запрос API:

  • task_id — string, идентификатор запроса, формат: 32 символа, 16-ричная строка
  • status_code — integer, дублирует код состояния HTTP
  • success — boolean, статус выполнения запроса
  • result — массив, содержит смысловую часть ответа
    • pages — массив, содержит страницы документа
      • text — массив, содержит весь найденный на странице текст
        • text — весь текст на странице
        • confidence — уровень уверенности алгоритма в корректности извлечения всего текста в блоке. Считается как усреднённый уровень уверенности по словам
        • coords — координаты текста на документе по четырём точкам: верхний левый угол, верхний правый, нижний левый, нижний правый
      • blocks — массив, который содержит найденные на странице блоки текста — например абзацы
        • block — текст блока
        • confidence — уровень уверенности алгоритма в корректности извлечения всего текста в блоке, считается как усреднённый уровень уверенности по словам
        • coords — координаты блока на странице по четырём точкам: верхний левый угол, верхний правый, нижний левый, нижний правый
      • words — массив, содержит найденные на странице слова
        • word — текст слова
        • confidence — уровень уверенности алгоритма в корректности извлечения текста слова
        • coords — координаты слова на странице по четырём точкам: верхний левый угол, верхний правый, нижний левый, нижний правый
        • image — изображение слова в формате base64
      • letters — массив, который содержит найденные на странице буквы
        • letter — текст буквы
        • confidence — уровень уверенности алгоритма в корректности извлечения текста буквы
    • input_images — оригинальное изображение из запроса в формате base64
  • task_tags — теги, если они переданы в параметре task_tags
  • traceback — сообщение об ошибке, которое содержит информацию о том, где произошла ошибка в коде и какие функции были вызваны перед ней. Это сообщение может помочь разработчикам понять причину возникновения ошибки и исправить ее. Передайте её нашей службе поддержки.
  • pages_count — число страниц в файле, актуально для PDF и DJVU
Остальные поля не несут практического смысла. Оставили их для совместимости со старыми версиями.
Last modified 19d ago