← На сайт
Label App · Инструкция

Приложение этикеток
от коробки до первой наклейки

Наводишь камеру на пачку — приложение считывает обжарщика, страну, сорт и обработку, добавляет дату и печатает готовую этикетку на термопринтер. Ниже — всё по шагам: что купить, где взять ключ распознавания, как подружить принтер и что делать, если этикетка вылезла обрезанной.

01 Что понадобится

Приложение ничего не устанавливает — это сайт. Открыл ссылку, и оно работает. Но у печати по Bluetooth из браузера есть жёсткие требования, лучше знать о них заранее.

Телефон Android + Chrome (или другой браузер на движке Chromium). Печать идёт по Web Bluetooth, а его поддерживает только он.
iPhone Печатать напрямую не сможет — Apple не пускает Bluetooth в браузер. Всё остальное работает: скан, распознавание, макет. Готовая этикетка сохраняется картинкой кнопкой «Сохранить картинку», дальше — через родное приложение принтера.
Принтер Chiteng CT-221B или Niimbot B1. Термо, без чернил — печатает нагревом по специальной ленте.
Лента Любая под твой принтер. Замерь её линейкой перед первой печатью — это самая частая причина кривых этикеток, см. шаг 05.
Ключ распознавания Первые несколько пачек — бесплатно, за счёт 18GRAMM: приложение работает сразу, ничего вводить не надо. Понравится — заводишь свой ключ, от 500 ₽ разово, и лимит снимается.
Интернет Нужен только в момент распознавания. Правка полей и печать идут без сети.

02 Ключ распознавания: где купить

Фото пачки читает нейросеть. Она живёт не в телефоне, а на чужом сервере, и каждый запрос к ней стоит денег — примерно как одно СМС. Чтобы приложение имело право туда обращаться, ему нужен API-ключ: длинная строка, личный пропуск с привязанным кошельком.

Сначала можно без ключа

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

Когда пробные попытки кончатся, приложение так и скажет. Дальше — свой ключ, по шагам ниже. Всё остальное (правка, макет, печать, журнал) работает без ключа всегда и бесплатно.

Почему через посредника

Ключ покупается не у OpenAI напрямую, а у российского посредника AITunnel. Причина простая: у OpenAI из России картой не заплатить. AITunnel принимает рублями, а наружу ходит сам — приложению разницы нет, адрес и формат те же.

  1. Зарегистрируйся на aitunnel.ru

    Открой aitunnel.ru и нажми «Создать аккаунт». Достаточно почты.

  2. Пополни баланс — минимум 500 ₽

    Оплата прямо в личном кабинете. 500 ₽ — это порядка пятисот распознанных пачек на самой дешёвой модели, то есть надолго. Деньги не сгорают и не списываются подпиской: тратится только то, что реально использовал.

  3. Создай ключ

    В кабинете есть раздел с API-ключами — нажми «создать». Получится строка вида sk-aitunnel-… длиной в несколько десятков символов.

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

  4. Перенеси ключ в телефон

    Если регистрировался с компьютера — отправь ключ себе в Telegram «избранное» или в заметки с синхронизацией. Вводить сорок символов руками с телефона незачем.

Ключ — это деньги

Кто угодно с этой строкой может тратить твой баланс. Не выкладывай её в чаты, скриншоты и переписки. Если засветил — зайди в кабинет, удали ключ и создай новый, старый сразу перестанет работать.

03 Ключ в приложении

  1. Открой приложение и зайди в Настройки

    Шестерёнка в правом верхнем углу главного экрана.

  2. Вставь ключ в поле «API-ключ AITunnel»

    Поле скрывает символы точками — так и задумано. Вставил и просто перешёл к следующему полю: ключ сохраняется сам, кнопки «сохранить» нет.

  3. Выбери модель распознавания

    По умолчанию GPT-4o mini — дёшево, около 1 ₽ за пачку, и в 9 случаях из 10 этого достаточно. Если попадаются пачки со сложной вёрсткой и текст читается плохо — переключись на Claude Sonnet 5: точнее, но дороже.

  4. Добавь приложение на домашний экран

    В меню браузера — «Добавить на главный экран». Появится обычная иконка, откроется без адресной строки, на вид неотличимо от установленного приложения.

Где хранится ключ

Только в памяти самого браузера на твоём телефоне. Он не уходит ни на наш сервер, ни куда-либо ещё — единственный адрес, куда его отправляет приложение, это API AITunnel, которому он и предназначен.

Обратная сторона: очистка данных браузера стирает ключ, вместе с журналом партий и настройками. Копия, сохранённая на шаге 02, страхует ровно от этого.

04 Подключение принтера

Один раз за сеанс. Браузер, в отличие от обычного приложения, не помнит устройство между запусками — это ограничение безопасности, а не недоделка.

  1. Включи принтер и Bluetooth на телефоне

    Именно Bluetooth, а не Wi-Fi. Заодно включи геолокацию — Android без неё не отдаёт браузеру список устройств поблизости.

  2. Выбери модель в Настройках

    Раздел «Принтер»: Chiteng CT-221B или Niimbot B1. От этого зависит язык команд, на неправильной модели печать просто не пойдёт.

  3. Нажми на строку с принтером

    Она есть и в Настройках, и на экране Печати. Браузер покажет системное окно со списком устройств — выбери своё. Точка слева станет зелёной, подпись сменится на «Подключён».

Не спаривай принтер в настройках Android

Если принтер уже привязан к телефону через системные настройки Bluetooth или через родное приложение производителя — он может не отдаться браузеру, канал занят. Отвяжи его там («забыть устройство») и подключайся только из приложения.

05 Размер ленты — самое важное

Если этикетка печатается обрезанной снизу, боком или вверх ногами — почти всегда дело не в повороте, а в том, что размер в приложении не совпал с физической лентой. Приложение рисует картинку ровно того размера, который ему назвали, и отдаёт принтеру. Он режет по своему.

ПЕЧАТАЮЩАЯ ГОЛОВКА ШИРИНА ДЛИНА ПОДАЧА лента едет сюда
Ширина — поперёк головки. Длина — вдоль движения ленты
  1. Замерь ленту линейкой

    Ширина — поперёк, вдоль печатающей головки. Длина — вдоль направления, куда лента выезжает. Округляй до целых миллиметров.

  2. Найди свой размер в списке

    Настройки → «Размер (ширина ленты × длина)». Если совпадение есть — выбери его, готово.

  3. Нет в списке — добавь

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

Проверка без расхода ленты

Экран Печати показывает точное превью того, что уйдёт на принтер. Если на превью всё помещается — на ленте тоже поместится. Если внизу что-то обрезано — размер всё ещё неверный, печатать рано.

06 Два макета

Приложение само смотрит на короткую сторону ленты и выбирает подходящий. Переключить можно вручную — на экране Результата и на экране Печати.

МакетКогдаЧто печатает
Компактная короткая сторона меньше 25 мм навеска · обжарщик · страна и сорт · обработка · дата. Всё по центру, крупно
Информативная короткая сторона от 25 мм то же плюс вкусовые ноты и QR-код на страницу кофе

Дата ставится на обоих — это и есть главный смысл этикетки: через две недели уже не вспомнить, когда пачка вскрыта. На мелкой ленте информативный макет заблокирован не из вредности: QR ниже сантиметра телефон не считает, а ноты сливаются в серую полосу.

07 Печать: полный проход

СНИМОК РАСПОЗНАТЬ ПРОВЕРИТЬ ПЕЧАТЬ до 3 кадров ≈1 ₽, нужен интернет навеска, ноты по Bluetooth
Весь путь — меньше минуты
  1. Сними пачку

    С главного экрана — «Сканировать». Наведи на этикетку по рамке и нажми круглую кнопку. Можно сделать до трёх кадров: например, лицо пачки и оборот с составом — они уйдут одним запросом и одной оплатой. Есть кнопка вспышки и переключения камеры, а рядом — галерея, если фото уже снято раньше.

  2. Нажми «Распознать»

    Пара секунд — и поля заполнены. Внизу мелькнёт реальная стоимость запроса в рублях.

    Кнопка «Вручную» пропускает этот шаг совсем: пустая карточка, заполняешь сам, ключ не тратится.

  3. Проверь и поправь

    Обжарщик, страна, сорт, обработка. У обжарщиков и стран есть подсказки при вводе. Правки запоминаются: если исправить «Сабмарин» на «SUBMARINE», в следующий раз приложение подставит правильное само.

  4. Впиши навеску

    Граммовка, с которой варишь этот кофе. Подставляется прошлая — обычно менять не надо.

  5. Ноты и ссылка — если макет информативный

    Часто и то и другое есть прямо на пачке, тогда поля уже заполнены. Если пусто, кнопка «Найти ↗» ищет в интернете — это отдельный платный запрос, поэтому он не запускается сам. Ссылка нужна для QR: нет ссылки — нет и QR-кода.

  6. «Печать этикетки»

    На экране печати — превью, размер ленты, макет, поворот и количество копий. Проверь превью, поставь число этикеток и жми «Печать».

    Кнопка ниже, «Сохранить картинку», выгружает готовую этикетку файлом — для iPhone или чтобы отправить на другой принтер.

Журнал партий

Каждая напечатанная этикетка попадает в журнал — вкладка внизу главного экрана. Оттуда можно перепечатать ту же партию, не сканируя заново и не тратя ключ. Сколько записей хранить, настраивается там же в Настройках.

08 Сколько это стоит

Само приложение бесплатное. Платное — только обращение к нейросети, и только когда ты его сам запускаешь.

ДействиеСписываетсяПримерно
Первые пачки без ключанет, платит 18GRAMMнесколько штук в день
Распознать пачкуда, один раз за нажатие≈ 1 ₽ на GPT-4o mini
«Найти ↗» — ноты и ссылкада, отдельноединицы рублей
Ввод вручнуюнет
Печать, перепечать из журналанет
Правка полей, смена макетанет

Приложение показывает точную сумму каждого запроса сразу после него — цифра всплывает внизу экрана. Остаток на балансе виден в личном кабинете AITunnel.

Как тратить меньше

Снимай пачку так, чтобы всё нужное попало в кадр с первого раза — повторное распознавание оплачивается заново. Три кадра за один запрос дешевле, чем три отдельных распознавания. А ноты ищи только для тех пачек, где реально печатаешь QR.

09 Если что-то не так

Пишет «на сегодня хватит — заведите свой ключ»

Пробные попытки за счёт 18GRAMM на сегодня кончились. Завтра будут снова, но если приложение зашло — проще завести свой ключ, шаг 02, и не считать попытки.

Ключ вставляется в настройках и начинает работать сразу, без перезагрузки.

«Не удалось распознать: HTTP 401»

Ключ есть, но сервер его не принял. Обычно — при копировании прицепился лишний пробел или строка скопировалась не целиком. Скопируй ключ ещё раз и вставь заново.

Если не помогло — ключ удалён или отозван в кабинете AITunnel. Создай новый.

«HTTP 402» или запросы перестали проходить

Кончились деньги на балансе. Зайди в кабинет AITunnel и пополни — ключ менять не нужно, он тот же самый.

Этикетка обрезана снизу — нет даты или QR

Размер ленты в приложении не совпадает с реальной. Это причина в девяти случаях из десяти.

Замерь ленту линейкой и выбери либо добавь точный размер — шаг 05. Крутить «Ориентацию» тут не поможет: она разворачивает картинку, но не меняет её размер.

Печатает вверх ногами или боком

Сначала убедись, что размер верный (предыдущий пункт) — перевёрнутая этикетка часто просто следствие перепутанных ширины и длины.

Если размер точно правильный, а разворот не тот — селектор «Ориентация» на экране печати: 180° переворачивает, 90° и 270° кладут набок.

Принтер не находится в списке

Проверь по порядку: принтер включён и не спит; Bluetooth на телефоне включён; геолокация включена (Android без неё не показывает браузеру устройства); принтер не занят другим приложением или системной парой — если он привязан в настройках Android, «забудь устройство» и попробуй снова.

И убедись, что открыт Chrome на Android. В Safari и на iPhone этого окна не будет никогда.

«Связь потеряна — подключитесь заново»

Принтер уснул или отошёл далеко. Нажми на строку принтера и выбери его снова — набранные поля при этом не теряются.

Камера не включается

Браузер спрашивает разрешение на камеру один раз; если тогда нажать «Запретить», больше не спросит. Открой настройки сайта в браузере (замочек в адресной строке) и разреши камеру, затем перезагрузи страницу.

Запасной путь: кнопка галереи слева от затвора — сними обычной камерой телефона и подложи готовое фото.

Распознаёт неправильно

Сними ближе и ровнее, без бликов — глянцевые пачки под лампой читаются плохо. Помогает вспышка. Сделай два кадра: лицо и оборот.

Если конкретный обжарщик стабильно пишется не так — просто исправь поле руками один раз. Приложение запомнит правку и дальше будет подставлять твой вариант.

Информативный макет недоступен — кнопка серая

Короткая сторона выбранной ленты меньше 25 мм. Это не ошибка: ноты и QR на такой ленте физически нечитаемы. Выбери размер побольше или печатай компактный макет.