Почему разработчики переходят с 2Captcha на CaptchaAI

Короткий ответ: сам переход занимает две строки кода, а меняет он экономику и покрытие типов. CaptchaAI принимает тот же формат запросов, что и 2Captcha — те же in.php и res.php, те же имена параметров, тот же JSON в ответе; вы меняете базовый URL и API-ключ, а логика опроса и обработка ошибок остаются как есть. Ниже — что вы получаете за эти две строки и где переход не даёт ничего.

Оплата за поток, а не за каждое решение

2Captcha берёт деньги за каждое решение — счёт растёт вместе с трафиком. CaptchaAI тарифицирует потоки: поток это одна задача CAPTCHA в работе, решений внутри тарифа неограниченно, суточных лимитов и надбавок за тип капчи нет.

Тарифы фиксированные: BASIC ($15/мес, 5 потоков), STANDARD ($30/мес, 15 потоков), ADVANCE ($90/мес, 50 потоков), PREMIUM ($170/мес, 100 потоков), CORPORATE ($240/мес, 150 потоков), ENTERPRISE ($300/мес, 200 потоков), далее VIP-1 ($1,500/мес, 1 000 потоков), VIP-2 ($4,500/мес, 3 000) и VIP-3 ($7,500/мес, 5 000).

Для команд, считающих бюджет в USD при выручке в местной валюте, это важнее скорости. Студия из Алматы держит парсер каталогов: в будни ровный поток, в дни распродаж — тройная нагрузка, и на оплате за решение мартовский счёт отличался от февральского вдвое. На потоках сумма известна первого числа, а считать её удобно по узкому месту: на reCAPTCHA v2 поток даёт около 60 решений в час.

Что меняется в покрытии типов

Сравнение по типам, которые и вызывают переход.

Две строки читайте внимательно. GeeTest v4 у CaptchaAI пока нет — тип заявлен как «скоро», и если проект держится на нём, переход ничего не решит. И наоборот, Cloudflare Challenge и BLS CAPTCHA — те пункты, ради которых уходят чаще всего. CaptchaFox, Friendly Captcha и Lemin — beta: в план, но не в SLA.

По скорости ориентируйтесь на потолки из документации: reCAPTCHA v3 — менее 4 с, Turnstile — менее 10 с, GeeTest v3 — менее 12 с, Cloudflare Challenge — менее 15 с, reCAPTCHA v2 — менее 60 с. У ручного решения время плавает ночью и в пиковые часы; у автоматического суточной волны нет.

Что меняется в reCAPTCHA v3

Дело не в скорости, а в пригодности токена: на v3 сайт смотрит на score. Токен с низким score валиден, но порога не проходит — форма молча отклоняет отправку, и в логах это выглядит как «решили, но не сработало».

# CaptchaAI — control the v3 score
import requests

resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "version": "v3",
    "googlekey": "SITE_KEY",
    "pageurl": "https://example.com",
    "action": "login",
    "json": 1,
})

Значение action должно совпадать с тем, что страница передаёт в grecaptcha.execute(): несовпадение — самая частая причина низкого score, и провайдер тут ни при чём.

Что меняется для порталов BLS

BLS CAPTCHA — типовой запрос у команд, автоматизирующих визовые и государственные порталы. У 2Captcha такого метода нет, у CaptchaAI это method=bls:

# CaptchaAI — BLS CAPTCHA with a high success rate
resp = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "bls",
    "pageurl": "https://bls-portal.example.com",
    "sitekey": "BLS_SITE_KEY",
    "json": 1,
})

Если пайплайн попутно собирает персональные данные, обрабатывайте только то, на что у вас есть основание — для РФ это 152-ФЗ «О персональных данных».

Как это выглядит на пайплайне

Дифф переезда:

# 2Captcha original
ENDPOINT = "https://2captcha.com"

# CaptchaAI — just change the URL
ENDPOINT = "https://ocr.captchaai.com"

# Same API format, same parameters, same response structure

Что это дало на конвейере (иллюстрация). Было, на 2Captcha:

Pipeline: 500 pages/hour
Avg solve time: 35s
Failure rate: 8%
Peak hour solve: 60-90s
Monthly cost: $300

Night shift: Slow (fewer workers)
Weekends: Slower (fewer workers)
Flash sales: Breaks (demand spike)

Стало, на CaptchaAI:

Pipeline: 1,200 pages/hour
Avg solve time: 12s
Failure rate: 3%
Peak hour solve: 12-15s
Monthly cost: $280

Night shift: Same speed
Weekends: Same speed
Flash sales: Same speed

Показательны последние три строки.

Как выглядит сама миграция

Рабочая функция после переезда — меняются только две верхние строки:

import requests
import time

# Only these two lines change:
API_KEY = "YOUR_CAPTCHAAI_KEY"
API_URL = "https://ocr.captchaai.com"

def solve_recaptcha(sitekey, pageurl):
    resp = requests.post(f"{API_URL}/in.php", data={
        "key": API_KEY,
        "method": "userrecaptcha",
        "googlekey": sitekey,
        "pageurl": pageurl,
        "json": 1,
    })
    task_id = resp.json()["request"]

    for _ in range(60):
        time.sleep(5)
        result = requests.get(f"{API_URL}/res.php", params={
            "key": API_KEY, "action": "get",
            "id": task_id, "json": 1,
        })
        data = result.json()
        if data["request"] != "CAPCHA_NOT_READY":
            return data["request"]

    raise TimeoutError("Solve timeout")

Порядок действий: заведите ключ, переключите некритичный воркер и сутки подержите оба сервиса параллельно. Остаток баланса 2Captcha не сгорает — старое переносите по мере расхода кредитов.

Три частые ошибки после переезда

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

Нужно ли переписывать обработку ошибок и тайм-ауты?

Нет. Коды состояния и формат ошибок совпадают с 2Captcha, включая CAPCHA_NOT_READY; логика повторов и экспоненциальная задержка переносятся как есть.

Сколько потоков брать вместо привычного баланса?

Считайте по пиковой параллельности, а не по числу решений за месяц: на 40 одновременных задач запас даёт ADVANCE ($90/мес, 50 потоков), на 10–12 хватит STANDARD ($30/мес, 15 потоков).

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

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

У нас проект на GeeTest v4 — есть смысл переходить?

Ради самого v4 — нет, поддержка заявлена как «скоро». Если v4 не единственный тип, перенесите остальные, а его оставьте на текущем сервисе.

Что почитать дальше

• Пошаговый план миграции с 2Captcha
• Сравнение цен на решение CAPTCHA

Заведите ключ CaptchaAI и прогоните пайплайн на обоих сервисах сутки — решение примут ваши логи, а не таблица сравнения.