Распознавание документов на сайте клиента — за один вечер
Клиент попросил, чтобы посетитель загружал фото рецепта, накладной или анкеты и сразу видел текст. Готовый блок, iframe в две строки или REST-запрос. Клиент оплачивает сам со своего аккаунта — вам не нужно перевыставлять и вести взаиморасчёты.
Клиент платит сам · Без карты — 40 запросов на тест · Домены из белого списка
Знакомо, если…
- Клиент хочет распознавание документов на сайте, а бюджет — как на форму обратной связи.
- Писать свою обвязку над чужим OCR ради одного проекта — неокупаемо.
- У крупных вендоров всё начинается со слова «свяжитесь с нами», а вам нужно вчера.
- Не хотите быть посредником в платежах и держать чужую подписку на себе.
Какие документы обрабатывает
| Что загружаете | Что получаете |
|---|---|
| Виджет | iframe с ограничением по домену, типы распознавания из кабинета |
| API | Один POST на /api/v1/ocr, multipart или base64, ответ — JSON |
| Биллинг | Клиент платит сам картой из своего кабинета |
| Ваша роль | Создать виджет, вставить код, передать доступ |
Как подключить
Виджет на сайт
Создаёте виджет в кабинете, копируете iframe — посетитель загружает фото на вашем сайте.
<iframe src="https://toolsie.ru/embed/ВАШ_ID" style="width:100%;height:480px;border:0" loading="lazy" ></iframe>Тильда, Битрикс, WordPress →
API из своей программы
Один POST — файл и тип распознавания. Ответ — JSON с текстом.
curl -X POST https://toolsie.ru/api/v1/ocr \ -H "Authorization: Bearer KEY" \ -F "tool=screenshot-v-kod" \ -F "file=@doc.jpg"PHP, Python, Node и другие →
Как поставить на …
Короткие инструкции под конструкторы и CMS. Для вызова из кода — сниппеты API.
Тильда
- В кабинете Тулси создайте виджет и укажите домен сайта на Тильде (например mysite.tilda.ws и боевой домен).
- Скопируйте iframe из кабинета.
- На нужной странице добавьте блок T123 «HTML-код» (или Zero Block → HTML).
- Вставьте iframe целиком, опубликуйте страницу.
- Проверьте с телефона: загрузка фото должна открываться и возвращать текст.
Если виджет не грузится — чаще всего домен не совпал с белым списком (www / без www).
<iframe src="https://toolsie.ru/embed/ВАШ_ID" width="100%" height="520" style="border:0;border-radius:8px" title="Распознавание" loading="lazy" ></iframe>
Битрикс24
- Создайте виджет в Тулси, в доменах укажите ваш портал (company.bitrix24.ru) и внешний сайт, если виджет на лендинге.
- Для сайта на Битрикс24: «Сайты» → нужная страница → блок HTML → вставьте iframe.
- Для смарт-процесса / карточки: разместите ссылку на страницу с виджетом или свой REST-вызов к API Тулси с сервера.
- Лимит списывается с аккаунта клиента — передайте ему доступ в кабинет Тулси или создайте ключ у него.
Ключ API не вставляйте в публичный JS Битрикс24 — только серверные сценарии или виджет.
1С-Битрикс (сайт)
- Создайте виджет, добавьте домен сайта в белый список.
- В админке: Контент → Страницы → нужный раздел → вставьте HTML с iframe (режим HTML-редактора).
- Либо вынесите iframe в include-область / компонент с статическим HTML.
- Сбросьте кеш страницы и проверьте с реального домена.
WordPress
- Создайте виджет в Тулси с доменом сайта.
- В редакторе блока добавьте «Произвольный HTML» и вставьте iframe.
- В классическом редакторе — вкладка «Текст», не «Визуально».
- Если стоит кеш/оптимизатор — исключите страницу с виджетом или разрешите iframe.
<!-- Gutenberg: блок «Произвольный HTML» --> <iframe src="https://toolsie.ru/embed/ВАШ_ID" width="100%" height="520" style="border:0" title="Распознавание" loading="lazy"></iframe>
Craftum, Creatium и другие конструкторы
- Найдите блок «HTML / Embed / Код» на странице.
- Вставьте iframe виджета, укажите домен конструктора в кабинете Тулси.
- Опубликуйте и проверьте с продакшн-URL (не только превью).
Превью-домены конструкторов часто другие — добавьте оба в белый список.
Чистый HTML
- Создайте виджет, скопируйте код.
- Вставьте 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)
- Зарегистрируйтесь, скопируйте ключ из кабинета.
- Шлите POST multipart на /api/v1/ocr с полями tool и file.
- Готовые сниппеты — на странице API.
См. /api-docs#primery
n8n / Make
- Нода HTTP Request: метод POST, URL https://toolsie.ru/api/v1/ocr
- Auth: Header — Authorization: Bearer ВАШ_КЛЮЧ
- Body: multipart — поле tool (текст) и file (бинарный файл из предыдущей ноды).
- Из ответа возьмите JSON → text. Для чеков/накладных разберите CSV.
В Make: модуль HTTP → Make a request, тип body = multipart/form-data.
Сколько это экономит
| Сценарий | Документов / мес | Тариф | Ручной ввод | За документ |
|---|---|---|---|---|
| Пилот у клиента | до 500 | API Старт1 980 ₽/мес | — | 3,96 ₽ |
| Сайт с формой загрузки | до 3 000 | API Рост4 980 ₽/мес | — | 1,66 ₽ |
| Несколько проектов / поток | до 15 000 | API Масштаб11 980 ₽/мес | — | 0,80 ₽ |
Тарифы
Три тарифа на всё: ниша меняет страницу, не продукт. Лимит общий для API и виджетов.
- · Клиент выбирает тариф сам — вам не нужно перевыставлять
- · Лимит общий для виджета и API
- · Подпись «Сделано в Тулси» на виджете пока остаётся
API Старт
1 980 ₽/мес
500 распознаваний
API Рост
4 980 ₽/мес
3 000 распознаваний
API Масштаб
11 980 ₽/мес
15 000 распознаваний
Частые вопросы
- Кто платит — я или клиент?
- Кто удобнее. Обычно клиент со своего аккаунта: вы создаёте виджет, передаёте доступ и не участвуете в платежах.
- Можно ли убрать подпись «Сделано в Тулси»?
- Сейчас нет. Блок нейтральный и не конфликтует с дизайном.
- Работает ли на нескольких доменах?
- Да, домены перечисляются при создании виджета, включая тестовый и продакшн.
- Есть ли песочница для теста?
- Да: после регистрации ключ создаётся сразу, без карты — 40 распознаваний в месяц. Для постоянной нагрузки оформите тариф API в кабинете.
- Что с лимитами и ошибками?
- Остаток лимита приходит в заголовках ответа и в поле usage. Подробности — в документации API.
- Есть ли SDK?
- Отдельного SDK нет: один эндпоинт, обычный multipart/form-data. Сниппеты — на /api-docs и на этой странице.