# YesCaptcha Docs

> YesCaptcha — API для распознавания капчи. Через один JSON-интерфейс решает reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF и капчу с изображением. Оплата за каждую задачу, при ошибке распознавания и тайм-ауте баллы возвращаются автоматически.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/ru/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/ru/llms-full.txt

## Начало работы

- [Введение](https://docs.yescaptcha.com/ru/getting-started/introduction.md): Что такое YesCaptcha. Решайте reCAPTCHA, hCaptcha, Turnstile, FunCaptcha и графические капчи через API или расширение браузера; оплата за каждую задачу, при неудаче баллы возвращаются автоматически.
- [Быстрый старт](https://docs.yescaptcha.com/ru/getting-started/quickstart.md): Отправьте первый запрос к YesCaptcha за 5 минут. Зарегистрируйтесь, скопируйте clientKey, пополните баланс, затем распознайте картинку с капчей через curl, Python или Node.js (ImageToTextTaskOcrBase, синхронно, 2 балла за запрос).
- [Адреса доступа](https://docs.yescaptcha.com/ru/getting-started/endpoints.md): Два endpoint API YesCaptcha — глобальный api.yescaptcha.com и для Китая cn.yescaptcha.com. Только HTTPS POST с JSON; создавайте и запрашивайте задачу на одном и том же endpoint.
- [Тарификация и возврат баллов](https://docs.yescaptcha.com/ru/getting-started/billing.md): Как YesCaptcha списывает баллы: 1,000 баллов = ¥1, фиксированная цена за каждый тип задачи; при неудаче и тайм-ауте баллы возвращаются автоматически, запросы с ошибкой не списываются; баланс должен быть больше 10 баллов; при жалобе на неверное распознавание изображений баллы возвращаются примерно через 24 часа.

## Справочник API

- [Запросы и ответы](https://docs.yescaptcha.com/ru/api/overview.md): Общие правила YesCaptcha API: POST JSON, аутентификация по clientKey, формат ответа с errorId, синхронные и асинхронные задачи, опрос каждые 5 секунд, тайм-аут 110 секунд, результат хранится около 10 минут, язык сообщений по Accept-Language.
- [createTask — создание задачи](https://docs.yescaptcha.com/ru/api/create-task.md): POST /createTask создаёт задачу распознавания капчи: параметры запроса (clientKey, task, softID), порядок проверок, асинхронные типы возвращают taskId, синхронные сразу возвращают solution; баланс должен быть больше 10 баллов.
- [getTaskResult — получение результата](https://docs.yescaptcha.com/ru/api/get-task-result.md): POST /getTaskResult возвращает результат асинхронной задачи: опрашивайте каждые 5 секунд, при processing продолжайте ждать, при ready берите solution, при ошибке прекращайте опрос; задача выполняется до 110 секунд, результат хранится около 10 минут, запросы не списывают баллы.
- [getBalance — запрос баланса](https://docs.yescaptcha.com/ru/api/get-balance.md): POST /getBalance возвращает баланс аккаунта в баллах (1,000 баллов = ¥1), а также балансы доли разработчика и реферального вознаграждения. Баллы не списываются; удобно для проверки clientKey.
- [getSoftID — запрос ID разработчика](https://docs.yescaptcha.com/ru/api/get-soft-id.md): POST /getSoftID возвращает ваш ID разработчика (softID) и накопленную сумму доли разработчика. Добавьте softID в запросы createTask, которые ваше ПО отправляет от имени других пользователей, чтобы получать долю.
- [report — сообщить о результате](https://docs.yescaptcha.com/ru/api/report.md): POST /report сообщает, верен ли результат задач; сообщайте честно и об успехах, и об ошибках. Для типов распознавания изображений ошибки нужно сообщить в течение 1 часа после создания задачи, возврат баллов после жалобы рассчитывается примерно через 24 часа.
- [useragent — получение User-Agent](https://docs.yescaptcha.com/ru/api/useragent.md): GET https://api.yescaptcha.com/useragent возвращает рекомендуемый браузерный User-Agent (обычный текст). Поле userAgent в задачах hCaptcha принимает только это значение.
- [Коды ошибок](https://docs.yescaptcha.com/ru/api/errors.md): Все коды ошибок YesCaptcha API, их значение и что делать: формат запроса, аккаунт и баланс, параллельные задачи и приостановка, результат задачи, параметры сайта, изображения, прокси, сервер. За запросы, вернувшие ошибку, баллы не списываются.
- [Лимит параллельных задач и автоматическая приостановка](https://docs.yescaptcha.com/ru/api/rate-limits.md): Лимит параллельных задач YesCaptcha (ERROR_THREADS_MAXIMUM, баллы не списываются, в приостановку не засчитывается), автоматическая приостановка при большом числе ошибок (100 за минуту — на 5 минут, ERROR_IP_BLOCKED_5MIN) и кэш неверных параметров (cached).

## Типы задач

- [Типы задач и цены](https://docs.yescaptcha.com/ru/tasks.md): Цены (в баллах, 1,000 баллов = ¥1) и способ возврата результата для всех публичных типов задач YesCaptcha: токены для reCAPTCHA, hCaptcha и Turnstile, Cookie для страницы проверки Cloudflare, результат распознавания для текстовых капч на изображениях и для распознавания изображений.
- [reCAPTCHA v2](https://docs.yescaptcha.com/ru/tasks/recaptcha-v2.md): Получение токенов reCAPTCHA v2 (обычная, невидимая и Enterprise-версии) через YesCaptcha: типы задач и цены, параметры запроса, примеры на curl/Python/Node.js и формат результата.
- [reCAPTCHA v3](https://docs.yescaptcha.com/ru/tasks/recaptcha-v3.md): Получение токенов reCAPTCHA v3 (включая Enterprise) через YesCaptcha: как заполнять pageAction, типы с фиксированной оценкой 0.7 и 0.9, типы задач и цены, параметры, примеры и формат результата.
- [hCaptcha](https://docs.yescaptcha.com/ru/tasks/hcaptcha.md): Получение токена hCaptcha через YesCaptcha: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 и HCaptchaTask с собственным прокси, как заполнять userAgent и rqdata и как использовать возвращаемый respKey.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/ru/tasks/turnstile.md): Получение токена Cloudflare Turnstile через YesCaptcha: TurnstileTaskProxyless, TurnstileTaskProxylessM1 и TurnstileTask со своим прокси, параметры, примеры и результат; чем Turnstile отличается от страницы проверки Cloudflare.
- [Страница проверки Cloudflare](https://docs.yescaptcha.com/ru/tasks/cloudflare-challenge.md): Как пройти страницу проверки Cloudflare («Just a moment...») через YesCaptcha и получить cf_clearance и другие cookie, User-Agent и содержимое страницы. Параметры CloudFlareTaskS2 и CloudFlareTaskS3, требования к прокси, результат, как его использовать и частые ошибки.
- [Распознавание текста на изображении](https://docs.yescaptcha.com/ru/tasks/image-to-text.md): Распознавайте английские буквы и цифры на изображении с помощью YesCaptcha. ImageToTextTaskOcrBase и ImageToTextTaskMuggle возвращают результат синхронно; ImageToTextTask и ImageToTextTaskM1 работают асинхронно и поддерживают регистр, только цифры, арифметические выражения и ограничения длины. Доступны индивидуальные модели.
- [Распознавание изображений reCAPTCHA v2](https://docs.yescaptcha.com/ru/tasks/recaptcha-classification.md): Распознавание картиночных заданий reCAPTCHA v2 через YesCaptcha (ReCaptchaV2Classification): отправьте изображение 3x3, 4x4 или 1x1 и ID вопроса — синхронно получите ячейки, на которые нужно нажать; цена зависит от размера изображения; таблица ID вопросов.
- [Распознавание изображений hCaptcha](https://docs.yescaptcha.com/ru/tasks/hcaptcha-classification.md): Распознавание изображений hCaptcha через YesCaptcha (HCaptchaClassification): выбор в сетке 3×3, клик в нужной точке, перетаскивание в нужное место, анимированные задания. Ответ синхронный, баллы не списываются, если цель не найдена.
- [Распознавание изображений FunCaptcha](https://docs.yescaptcha.com/ru/tasks/funcaptcha-classification.md): Распознавание картинок-заданий FunCaptcha (Arkose Labs) через YesCaptcha (FunCaptchaClassification). Загрузите изображение задания (сетка из 6 ячеек или задание со стрелками, где изображения расположены слева и справа) и вопрос на английском, и синхронно получите номер нужного изображения. Поддерживаются все типы заданий.
- [Распознавание изображений AWS WAF / bCaptcha](https://docs.yescaptcha.com/ru/tasks/aws-bcaptcha-classification.md): Распознавайте капчи AWS WAF CAPTCHA и bCaptcha с сеткой 3×3 через YesCaptcha (AwsClassification, bCaptchaClassification). Загрузите целое изображение и вопрос — синхронно получите ячейки, на которые нужно нажать.

## Расширение для браузера

- [YesCaptcha Assistant — расширение браузера](https://docs.yescaptcha.com/ru/extension.md): YesCaptcha Assistant (расширение браузера) для Chrome и Firefox автоматически распознаёт и кликает капчи reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF и другие. Расширение бесплатное, баллы списываются за API, которые оно использует. Ссылки на магазины, загрузка пакетов и видео установки для Chrome, BitBrowser и Kiwi Browser.

## Руководства

- [Как определить тип капчи](https://docs.yescaptcha.com/ru/guides/identify-captcha.md): Как понять, какая капча на странице: reCAPTCHA v2, невидимая v2, v3, Enterprise, hCaptcha, чем Cloudflare Turnstile отличается от страницы проверки Cloudflare и какой тип задачи YesCaptcha использовать.
- [Как найти параметры reCAPTCHA](https://docs.yescaptcha.com/ru/guides/find-recaptcha-parameters.md): Как найти websiteKey (sitekey), websiteURL, pageAction для v3 и callback-функцию reCAPTCHA на вкладках Network, Sources и Console в инструментах разработчика. Есть скрипт для автоматического поиска.
- [Поиск параметров hCaptcha](https://docs.yescaptcha.com/ru/guides/find-hcaptcha-parameters.md): Как найти websiteKey (sitekey), websiteURL и rqdata для версии Enterprise в hCaptcha: найдите data-sitekey в исходном коде страницы или запросы checksiteconfig и getcaptcha на вкладке Network.
- [Поиск параметров Turnstile](https://docs.yescaptcha.com/ru/guides/find-turnstile-parameters.md): Как найти websiteKey (sitekey, начинается с 0x) и websiteURL для Cloudflare Turnstile: найдите data-sitekey или turnstile.render в исходном коде страницы либо запросы к challenges.cloudflare.com на вкладке Network.
- [Использование токена reCAPTCHA](https://docs.yescaptcha.com/ru/guides/submit-recaptcha-token.md): Что делать с токеном reCAPTCHA (gRecaptchaResponse): принцип работы, отправка обычным HTTP-запросом (поле g-recaptcha-response), подстановка в страницу в браузере с вызовом callback-функции, а также полный пример на Python для демо-страницы Google.
- [Клики по картинкам reCAPTCHA v2 через Selenium](https://docs.yescaptcha.com/ru/guides/recaptcha-click-selenium.md): Python, Selenium 4 и ReCaptchaV2Classification для автоматических кликов по картинкам reCAPTCHA v2 в браузере: вызов капчи, чтение вопроса и изображения, запрос к API распознавания, клики по ячейкам и отправка формы. Полный пример кода.
- [Имитация кликов для hCaptcha через Selenium](https://docs.yescaptcha.com/ru/guides/hcaptcha-click-selenium.md): Как с помощью Python, Selenium 4 и HCaptchaClassification автоматически пройти задание hCaptcha с сеткой 3×3 в браузере: клик по чекбоксу, чтение вопроса и 9 изображений, вызов API распознавания, клики и отправка. Полный пример кода.

## Примеры кода

- [Примеры кода и SDK](https://docs.yescaptcha.com/ru/samples.md): Готовые к запуску примеры кода YesCaptcha (Python, Node.js, curl, C#, Easy Language) и неофициальные SDK от сообщества (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/ru/samples/python.md): Примеры YesCaptcha на Python: проверка баланса, распознавание капчи-изображения, переиспользуемый класс клиента (создание задачи, опрос каждые 5 секунд), управление параллельными задачами через asyncio и отправка reCAPTCHA с помощью requests и Selenium.
- [Node.js](https://docs.yescaptcha.com/ru/samples/nodejs.md): Примеры YesCaptcha на Node.js (Node.js 18+, встроенный fetch, без сторонних библиотек): проверка баланса, распознавание изображения с капчей и переиспользуемый клиентский класс (создание задачи, опрос каждые 5 секунд).
- [C#](https://docs.yescaptcha.com/ru/samples/csharp.md): Пример YesCaptcha на C# (.NET 6+, HttpClient и System.Text.Json): запрос баланса, создание задачи reCAPTCHA v2 и опрос результата каждые 5 секунд.
- [Easy Language (易语言)](https://docs.yescaptcha.com/ru/samples/easy-language.md): Примеры YesCaptcha на Easy Language (易语言) от пользователей: клики по reCAPTCHA и hCaptcha, распознавание изображений FunCaptcha и отправка токена reCAPTCHA; пакеты для загрузки и основные моменты вызова API.

## Аккаунт

- [Несколько clientKey: лимиты расходов, белый список IP и срок действия](https://docs.yescaptcha.com/ru/account/client-keys.md): В одном аккаунте YesCaptcha может быть до 20 clientKey, все они списывают баллы с одного баланса. Для каждого можно отдельно задать лимит расходов (в день, неделю, месяц или единоразовый, сброс по пекинскому времени), белый список IP и срок действия, изменения вступают в силу за несколько секунд.
- [Пополнение и VIP](https://docs.yescaptcha.com/ru/account/recharge.md): Как пополнить баланс YesCaptcha (WeChat Pay, Alipay, PayPal, криптовалюта); 1,000 баллов = ¥1. Накопленная сумма пополнений автоматически повышает уровень от VIP 1 до VIP 10, а каждое следующее пополнение получает бонусные баллы.
- [Реферальное вознаграждение](https://docs.yescaptcha.com/ru/account/referral.md): Реферальная программа YesCaptcha: приглашённый пользователь при регистрации получает уровень VIP (ваш уровень минус 1, от VIP1 до VIP6), а вы получаете 20% от его расходов (по 10% каждому, если действует и доля разработчика). Вознаграждение можно перевести на баланс или вывести в Панели от ¥100.
- [Доля разработчика](https://docs.yescaptcha.com/ru/account/developer.md): Доля разработчика YesCaptcha: добавьте свой softID в запросы, которые ваше ПО отправляет от имени пользователей, и получайте 20% от их расходов (по 10%, если у пользователя есть пригласивший); переведите долю на баланс или выведите от ¥100 в Панели.

## Помощь

- [Часто задаваемые вопросы](https://docs.yescaptcha.com/ru/help/faq.md): Частые вопросы о YesCaptcha: списываются ли баллы при неудачном распознавании, сколько живёт токен, процент успешных проверок, кто распознаёт — человек или машина, могут ли заблокировать аккаунт, можно ли использовать один clientKey в нескольких местах, какой endpoint выбрать, чем расширение отличается от API.
- [Проблемы с подключением и сетью](https://docs.yescaptcha.com/ru/help/troubleshooting.md): Что делать, если не удаётся подключиться к API YesCaptcha: Failed to establish a new connection, сбой DNS, влияние прокси-программ, ошибки SSL-сертификата (Certificate has expired, SSLEOFError).
- [Связаться с нами](https://docs.yescaptcha.com/ru/help/contact.md): Связаться с поддержкой YesCaptcha: WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official, почта yescaptcha@gmail.com, часы работы 9:00–21:00 UTC+8.
- [История изменений сервиса](https://docs.yescaptcha.com/ru/changelog.md): Изменения YesCaptcha, которые затрагивают пользователей, по датам: новые и отключённые типы задач, правила тарификации и возврата баллов, лимит параллельных задач, перенос документации. Ведётся с октября 2026 года.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)