Создание пользовательского модуля
Описание
Функция создания пользовательского модуля позволяет обучить систему распознавать один конкретный вид капчи. Это повышает скорость и точность распознавания нестандартных капч и снижает вероятность ошибок.
Чтобы перейти на страницу обучения модуля, кликните по вашему email в верхней правой части сайта и выберите соответствующий пункт меню.

Как это работает
Кратко процесс выглядит так:
- Вы собираете капчи и упаковываете в архив.
- Отправляете нам с указанием имени модуля.
- Вносите депозит $10 на баланс (средства остаются на балансе и не списываются).
- Мы создаём модуль.
- Вы отправляете задачи на распознавание, указывая имя созданного модуля.
Ниже описан каждый шаг более подробно.
1. Сбор капчи
Сколько капч нужно?
На странице Обучения модулей отметьте типы символов, встречающихся в вашей капче. После этого появится подсказка, сколько капч необходимо собрать и загрузить:

Поддерживаемые форматы изображений
- jpg
- jpeg
- png
Как собирать капчи
Например, с помощью ZennoPoster.
Предположим, вы регистрируете аккаунты на сайте, где используется капча, для которой вы хотите создать пользовательский модуль. Существует несколько способов собрать такие капчи:
- Возможно, у вас уже есть работающий проект для данного сайта, и вы уже решаете соответствующую капчу. В этом случае в экшене Распознать капчу, на вкладке Дополнительно предусмотрена опция Сохранение, которая как раз и создана для таких случаев.
- Альтернативный способ: откройте страницу с капчей, у которой есть кнопка «Обновить картинку». Отправляйте капчу на распознавание через сервис или распознавайте вручную (перед этим настроив в экшене Сохранение капч), затем обновляйте изображение и повторяйте процесс до достижения необходимого количества капч.
Не рекомендуется собирать капчи в десятки или сотни потоков одновременно, так как это может вызвать проблемы с работой сайта.
2. Отправка архива капч

2.1. Название
Сначала необходимо задать имя модуля. Оно должно содержать только латинские символы.
В названии модуля нельзя использовать слово captcha.
2.2. Типы символов
Отметьте типы символов, которые встречаются на вашей капче. От выбранных пунктов зависит общее количество капч, необходимое для обучения модуля.
Можно отметить один или несколько вариантов из предложенного списка.

В этом списке обязательно должен быть отмечен один из пунктов (или несколько): "Cодержит кириллицу", "Содержит латиницу", "Содержит цифры"
2.3. Расположение разметки
Здесь необходимо выбрать способ хранения ответов на капчи.

Всё довольно просто:
- Нет - выбираете этот пункт, если у вас нет ответов на капчи (в этом случае обучение модуля может занять больше времени)
- В именах файлов - когда имя каждой картинки-капчи и есть ответ на неё (не всегда ответ на капчу можно сохранить в качестве имени файла: в операционных системах есть ограничение на используемые символы в названиях)
- В файле внутри архива - если ответы сохранены в отдельном файле, то это должен быть простой текстовый файл, с расширением .txt
- Имя файла - answers.txt
- Должен быть расположен внутри архива вместе с капчами
- Формат - имяФайлаКапчи:ответНаКапчу, каждая капча с новой строки. Пример:
captcha1.png:d9li1
captcha2.png:2zhnw
captcha3.png:99loe
2.4. Отправка архива
После того как вы указали имя модуля, выбрали типы символов и расположение ответов, осталось только загрузить zip-архив с капчами и отправить нам.

2.5. Оплата
- Если всё было сделано правильно, то в таблице отобразится ваша заявка со статусом Validated.
- После этого необходимо внести депозит $10 на баланс в расчёте на 1 модуль.
Средства за обучение не списываются, они остаются на балансе. Вы можете их потратить на распознавание любых капч в любое время.
- После успешного пополнения статус первого загруженного модуля изменится на Paid.
3. Статусы
Validated

Данный статус назначается после того, как вы отправите форму (если всё было сделано правильно).
Для модулей с этим статусом доступна возможность удаления - если вы загрузили неправильный архив или задали некорректное имя модуля, вы можете удалить модуль, внести необходимые исправления и отправить его повторно.
Paid

Оплата за модуль принята.
ValidatedInDepth

Подготовительные работы.
Annotated

Разметка капч произведена. Идёт процесс обучения.
Trained

Модуль готов! Теперь на него можно отправлять капчи.
4. Отправка капч на конкретный модуль
Существует несколько способов указать модуль для распознавания:
- Добавить аргумент CapMonsterModule с именем необходимого модуля при отправке запроса на /createTask (если вы взаимодействуете напрямую с нашим API)
- Добавить имя модуля в поле ApiKey (очень удобно при использовании чужих программ, когда нет возможности изменить отправляемые запросы)
FAQ
Как долго длится обучение модуля?
Обучение одного обычно происходит в течение суток.
Обратите внимание: обучение производится в рабочие дни с понедельника по пятницу. Если вы отправили заявку в пятницу, то он будет готов в начале следующей недели.
Я хочу обучить сразу несколько модулей, как мне правильно это сделать?
Загрузите первый архив с капчами и оплатите его, затем повторите процесс для второго архива и так далее для всех модулей.
Ориентировочное время готовности одного модуля составляет примерно один рабочий день.
Напротив моего модуля в колонке “Комментарий” появилась надпись “Ошибка” : Что мне делать?

Не паникуйте Подождите немного.
Если спустя сутки ничего не изменилось, напишите в поддержку и мы вам обязательно поможем.
Я загрузил не тот архив, могу ли я его переотправить?
Если вы ещё не оплатили модуль и у него статус Validated, то вы можете самостоятельно его удалить. Подробности можете найти в описании статуса Validated.
Что за колонка “Управление” в таблице? У меня там ничего нет.
В этой колонке отображается кнопка «Удалить» только для модулей со статусом Validated.
Для модулей с другими статусами данная колонка остаётся пустой.
Почему к имени моего модуля были добавлены какие-то символы?
Имя модуля автоматически дополнительно модифицируется для обеспечения уникальности. Так как несколько пользователей могут выбрать одинаковое название, система добавляет случайные символы, чтобы избежать путаницы. Это гарантирует, что каждая капча будет направлена именно на ваш модуль.
Могу ли я получить обученный модуль для программы CapMonster2?
Нет. Обученный модуль доступен только в рамках сервиса CapMonster Cloud.
Меня не устраивает качество обучения. Что делать?
Пожалуйста, обратитесь в поддержку.
У меня есть вопрос, который здесь не освещён. Куда мне обращаться?
Пожалуйста, обратитесь в поддержку.
