Часто задаваемые вопросы

Списываются ли баллы, если YesCaptcha не смог распознать капчу?

Нет. За задачи с неудачным распознаванием (ERROR_CAPTCHA_UNSOLVABLE) и за задачи с истёкшим временем ожидания (ERROR_TASK_TIMEOUT) баллы возвращаются автоматически, а за запросы, на которые вернулся код ошибки (например, из-за неверных параметров), баллы не списываются. Если вы получили токен, но целевой сайт его не принял, задача считается успешной и оплачивается: мы не знаем, какое решение принял сайт. Для типов распознавания изображений, где результат оказался неверным, можно сообщить о неверном результате и получить возврат баллов после жалобы. Подробнее: Оплата и возврат баллов.

Сколько стоит одно распознавание?

За каждый тип задачи списывается фиксированное число баллов, 1,000 баллов = ¥1; цены зависят от типа. Все цены: Типы задач и цены, версия для машинного чтения: /data/task-types.json.

Сколько действует токен?

Токены reCAPTCHA, hCaptcha и Turnstile одноразовые. Токен reCAPTCHA действует примерно 120 секунд; рекомендуем отправлять его в течение 60 секунд после получения. Срок действия определяет производитель капчи.

Почему полученный токен иногда не проходит проверку?

Принимает ли токен сайт, решает сам целевой сайт. Он учитывает оценку, IP, окружение браузера и другие факторы, а порог может измениться в любой момент, поэтому процент успешных проверок зависит от сайта. Можно сравнить другие типы задач для той же капчи, выбрать тип со своим прокси и отправлять токен через тот же прокси или перейти на распознавание изображений и кликать в браузере по-настоящему.

Сколько занимает распознавание?

Асинхронные задачи обычно выполняются от нескольких секунд до нескольких десятков секунд, максимум около 110 секунд (у некоторых типов 180–220 секунд); по истечении времени баллы возвращаются автоматически. Распознавание изображений и распознавание текста на изображении синхронные: результат приходит в ответ на один запрос.

Распознаёт человек или машина?

Машина, на основе моделей машинного обучения.

Могут ли заблокировать мой аккаунт из-за использования YesCaptcha?

Мы возвращаем только результат распознавания и не имеем доступа к вашему аккаунту на целевом сайте. Как сайт оценивает действия и блокирует ли аккаунты, решает сам сайт; соблюдайте его правила. YesCaptcha можно использовать только в законных целях, использование в незаконных целях запрещено.

Можно ли использовать один clientKey одновременно в нескольких программах и браузерах?

Можно. Запросы одного аккаунта учитываются вместе в лимите параллельных задач и расходуют один и тот же баланс.

Какой endpoint выбрать: глобальный или для Китая?

Если сервер находится в материковом Китае, используйте cn.yescaptcha.com, в остальных регионах — api.yescaptcha.com. Результат нужно запрашивать на том же endpoint, где была создана задача. См. Адреса подключения.

Чем расширение браузера отличается от API?

Расширение тоже вызывает тот же API. Оно устанавливается бесплатно, баллы списываются за использованные вызовы API; подходит, если нужно работать в браузере без кода. API подходит для пакетной обработки в программах. См. Расширение браузера.

Почему меня приостановили и вернулся ERROR_IP_BLOCKED_5MIN?

С одного clientKey за минуту пришло слишком много ошибочных запросов, и он был автоматически приостановлен на несколько минут; по истечении срока доступ восстанавливается сам. Поле blockReason в ответе содержит код ошибки, вызвавшей приостановку; исправьте программу в соответствии с ним. См. Лимит параллельных задач и автоматическая приостановка.

Какие сайты поддерживаются?

Мы распознаём типы капч, а не конкретные сайты. Пройдёт ли проверка, зависит от настроек целевого сайта, поэтому сначала протестируйте на небольшой партии. Если сайт пока не поддерживается, вернётся ERROR_DOMAIN_NOT_ALLOWED.