Тулси
ВойтиРегистрация

Виджет распознавания на сайт

Нужно, чтобы посетитель вашего сайта сам загрузил фото рецепта, чека или рукописи и сразу увидел текст? Вставьте готовый блок Тулси — как форму обратной связи, только для распознавания.

Создать аккаунтТарифыAPI для программТильда, Битрикс…

Как это работает

  1. 1. В кабинете создаёте виджет: название, тип распознавания, список своих сайтов.
  2. 2. Копируете короткий код и вставляете на страницу — в конструктор, CMS или HTML.
  3. 3. Посетитель загружает фото, видит текст. Запросы списываются с вашего лимита API.

Как выглядит код вставки

После создания виджета в кабинете появится готовый фрагмент. Примерный вид:

<iframe
  src="https://toolsie.ru/embed/ВАШ_ID"
  width="100%"
  height="520"
  style="border:0;border-radius:8px"
  title="Распознавание"
></iframe>

Работает на своём домене: укажите, с каких сайтов виджет разрешён (например clinic.ru). С чужого адреса запросы не пройдут.

Что умеет виджет

Те же виды распознавания, что и в API: выбираете один тип на виджет.

  • Рукопись → обычный текст
  • Почерк врача → текст
  • Старинная рукопись → текст
  • Рукопись с формулами → LaTeX
  • Рукописная таблица → таблица для Excel
  • Чек → таблица для Excel
  • Накладная → таблица для Excel
  • Визитка → таблица контактов
  • Любая форма → структурированные данные
  • Фото доски → текст
  • Фото таблицы → таблица для Excel
  • Скриншот интерфейса → HTML
  • tekst-so-skrinshota
  • pokazaniya-schetchikov
  • konspekt-v-markdown

Кому это удобно

Учёт и HoReCa

Чеки и накладные. Первичка · поставщики

Веб-студии

Блок на сайт клиента. Сценарий

Анкеты и поле

Бумажный бланк — в данные. Сценарий

Ещё ниши

Образование, наука, ветклиники, генеалогия и другие — в решениях.

Как поставить на …

Короткие инструкции под конструкторы и CMS. Для вызова из кода — сниппеты API.

Тильда

  1. В кабинете Тулси создайте виджет и укажите домен сайта на Тильде (например mysite.tilda.ws и боевой домен).
  2. Скопируйте iframe из кабинета.
  3. На нужной странице добавьте блок T123 «HTML-код» (или Zero Block → HTML).
  4. Вставьте iframe целиком, опубликуйте страницу.
  5. Проверьте с телефона: загрузка фото должна открываться и возвращать текст.

Если виджет не грузится — чаще всего домен не совпал с белым списком (www / без www).

<iframe
  src="https://toolsie.ru/embed/ВАШ_ID"
  width="100%"
  height="520"
  style="border:0;border-radius:8px"
  title="Распознавание"
  loading="lazy"
></iframe>

Битрикс24

  1. Создайте виджет в Тулси, в доменах укажите ваш портал (company.bitrix24.ru) и внешний сайт, если виджет на лендинге.
  2. Для сайта на Битрикс24: «Сайты» → нужная страница → блок HTML → вставьте iframe.
  3. Для смарт-процесса / карточки: разместите ссылку на страницу с виджетом или свой REST-вызов к API Тулси с сервера.
  4. Лимит списывается с аккаунта клиента — передайте ему доступ в кабинет Тулси или создайте ключ у него.

Ключ API не вставляйте в публичный JS Битрикс24 — только серверные сценарии или виджет.

1С-Битрикс (сайт)

  1. Создайте виджет, добавьте домен сайта в белый список.
  2. В админке: Контент → Страницы → нужный раздел → вставьте HTML с iframe (режим HTML-редактора).
  3. Либо вынесите iframe в include-область / компонент с статическим HTML.
  4. Сбросьте кеш страницы и проверьте с реального домена.

WordPress

  1. Создайте виджет в Тулси с доменом сайта.
  2. В редакторе блока добавьте «Произвольный HTML» и вставьте iframe.
  3. В классическом редакторе — вкладка «Текст», не «Визуально».
  4. Если стоит кеш/оптимизатор — исключите страницу с виджетом или разрешите iframe.
<!-- Gutenberg: блок «Произвольный HTML» -->
<iframe src="https://toolsie.ru/embed/ВАШ_ID" width="100%" height="520" style="border:0" title="Распознавание" loading="lazy"></iframe>

Craftum, Creatium и другие конструкторы

  1. Найдите блок «HTML / Embed / Код» на странице.
  2. Вставьте iframe виджета, укажите домен конструктора в кабинете Тулси.
  3. Опубликуйте и проверьте с продакшн-URL (не только превью).

Превью-домены конструкторов часто другие — добавьте оба в белый список.

Чистый HTML

  1. Создайте виджет, скопируйте код.
  2. Вставьте iframe на страницу. Домен страницы должен быть в списке виджета.
<iframe
  src="https://toolsie.ru/embed/ВАШ_ID"
  width="100%"
  height="520"
  style="border:0;border-radius:8px"
  title="Распознавание"
  loading="lazy"
></iframe>

Бэкенд (PHP, Python, Node)

  1. Зарегистрируйтесь, скопируйте ключ из кабинета.
  2. Шлите POST multipart на /api/v1/ocr с полями tool и file.
  3. Готовые сниппеты — на странице API.

См. /api-docs#primery

n8n / Make

  1. Нода HTTP Request: метод POST, URL https://toolsie.ru/api/v1/ocr
  2. Auth: Header — Authorization: Bearer ВАШ_КЛЮЧ
  3. Body: multipart — поле tool (текст) и file (бинарный файл из предыдущей ноды).
  4. Из ответа возьмите JSON → text. Для чеков/накладных разберите CSV.

В Make: модуль HTTP → Make a request, тип body = multipart/form-data.

Частые вопросы

Нужен ли программист?

Чтобы вставить код на страницу — обычно нет: копируете блок из кабинета в конструктор или HTML. Если сайт на сложной платформе, попросите того, кто его обслуживает, вставить iframe.

Чем виджет отличается от API?

Виджет — готовый блок для посетителей сайта. API — доступ из вашей программы: вы сами шлёте фото и обрабатываете ответ. Лимит распознаваний общий.

Можно ли поставить виджет на несколько сайтов?

Да. Укажите все нужные домены при создании. Можно создать несколько виджетов (до 10) с разными типами распознавания.

Брендинг Тулси остаётся?

Внизу блока есть небольшая подпись «Сделано в Тулси». Сам блок выглядит нейтрально и подходит под обычный сайт.

Виджет распознавания на сайт — Тулси