CAPTCHA resolve quedas de taxa: diagnóstico de regressão de desempenho

Sua taxa de resolução de CAPTCHA caiu de 95% para 60% durante a noite. Antes de entrar em contato com o suporte, este guia percorre um diagnóstico estruturado para identificar a causa raiz – seja seu código, proxy, site de destino ou serviço CaptchaAI.

Árvore de decisão diagnóstica

Solve rate dropped
├── Is the API returning errors? → Check error codes
│   ├── ERROR_WRONG_USER_KEY → API key issue
│   ├── ERROR_ZERO_BALANCE → Balance depleted
│   ├── ERROR_NO_SLOT_AVAILABLE → Rate limiting
│   └── ERROR_CAPTCHA_UNSOLVABLE → CAPTCHA changed
├── Are tokens returned but rejected by the target site?
│   ├── Token expired before submission → Speed up injection
│   ├── Sitekey changed → Re-extract from page
│   └── Domain mismatch → Check pageurl parameter
├── Are proxies failing?
│   ├── Proxy banned by target → Rotate proxies
│   └── Proxy timeout → Check proxy health
└── Did the target site change?
    ├── New CAPTCHA type → Update method parameter
    ├── JavaScript changes → Re-analyze page
    └── Rate limiting by site → Reduce frequency

Etapa 1: verifique os códigos de erro CaptchaAI

Execute um script de diagnóstico rápido:

# diagnose_solve_rate.py
import os
import requests
from collections import Counter

API_KEY = os.environ.get("CAPTCHAAI_KEY", "YOUR_API_KEY")

def check_balance():
    """Verify API key and balance."""
    resp = requests.get("https://ocr.captchaai.com/res.php", params={
        "key": API_KEY, "action": "getbalance", "json": "1",
    })
    result = resp.json()
    print(f"Balance: {result}")
    return result

def test_solve(sitekey, pageurl, runs=5):
    """Run test solves and collect error statistics."""
    errors = Counter()
    successes = 0

    for i in range(runs):
        # Submit
        resp = requests.get("https://ocr.captchaai.com/in.php", params={
            "key": API_KEY,
            "method": "userrecaptcha",
            "googlekey": sitekey,
            "pageurl": pageurl,
            "json": "1",
        })
        result = resp.json()

        if result.get("status") != 1:
            errors[result.get("request", "UNKNOWN")] += 1
            print(f"  Run {i+1}: Submit error: {result.get('request')}")
            continue

        task_id = result["request"]
        import time
        time.sleep(15)

        # Poll
        for _ in range(25):
            poll = requests.get("https://ocr.captchaai.com/res.php", params={
                "key": API_KEY, "action": "get",
                "id": task_id, "json": "1",
            })
            poll_result = poll.json()

            if poll_result.get("status") == 1:
                successes += 1
                print(f"  Run {i+1}: Solved")
                break
            if poll_result.get("request") != "CAPCHA_NOT_READY":
                errors[poll_result.get("request", "UNKNOWN")] += 1
                print(f"  Run {i+1}: Error: {poll_result.get('request')}")
                break
            time.sleep(5)
        else:
            errors["TIMEOUT"] += 1
            print(f"  Run {i+1}: Timeout")

    print(f"\nResults: {successes}/{runs} solved")
    if errors:
        print(f"Errors: {dict(errors)}")

# Run diagnostics
print("=== Balance Check ===")
check_balance()

print("\n=== Test Solves ===")
test_solve("YOUR_SITEKEY", "https://your-staging.example.com", runs=5)

Etapa 2: verificar os parâmetros do site de destino

A causa mais comum de quedas na taxa de resolução é uma alteração na chave do site ou na estrutura da página.

Verifique se a chave do site mudou

Visite a página de destino, abra DevTools (F12) e pesquise:

• reCAPTCHA: chamada data-sitekey ou grecaptcha.render
• Cloudflare Turnstile: data-sitekey no widget Cloudflare Turnstile
• GeeTest: parâmetro gt na inicialização do GeeTest

Compare com a chave do site no seu código. Um único caractere alterado causa 100% de falha.

Verifique se o tipo de CAPTCHA mudou

Alguns sites migram entre provedores de CAPTCHA:

• reCAPTCHA v2 → reCAPTCHA v3 (invisível)
• reCAPTCHA → Cloudflare Turnstile
• Imagem CAPTCHA → reCAPTCHA Enterprise

Se o tipo mudou, atualize seu parâmetro method adequadamente.

Etapa 3: avaliar a integridade do proxy

A qualidade do proxy afeta diretamente as taxas de resolução, especialmente para CAPTCHAs baseados em tokens onde CaptchaAI usa seu proxy.

Teste primeiro sem um proxy (se o tipo CAPTCHA suportar resolução sem proxy) para isolar se o proxy é o problema.

Etapa 4: verificar o tempo do token

Os tokens CAPTCHA têm validade limitada:

Se o seu pipeline demorar muito entre o recebimento do token e a injeção no formulário, o token expirará e o site o rejeitará.

Correção: Meça o tempo entre getTaskResult e o envio do formulário. Se > 60 segundos, otimize seu pipeline.

Etapa 5: analisar a distribuição de erros

Classifique seus erros por frequência para encontrar a causa raiz:

Etapa 6: compare com a linha de base

Se você executou benchmarks anteriormente, compare as métricas atuais com sua linha de base:

Quando entrar em contato com o suporte

Entre em contato com o suporte CaptchaAI se:

• Todas as etapas de diagnóstico são aprovadas, mas a taxa de resolução permanece baixa
• A taxa ERROR_CAPTCHA_UNSOLVABLE excede 20% em chaves de site em funcionamento anteriormente
• O saldo mostra correto, mas a solução ainda falha
• O problema persiste por mais de 2 horas

Inclua em seu relatório:

1. Tipo CAPTCHA e chave do site
2. URL do site de destino
3. Distribuição de erros (do script de diagnóstico)
4. Quando o problema começou
5. Quaisquer alterações que você fez em seu código

Referência rápida para solução de problemas

Perguntas frequentes

O CaptchaAI pode resolver a alteração da taxa para um site específico?

Sim. Se um site atualizar sua configuração CAPTCHA (por exemplo, desafios mais difíceis, recursos empresariais), as taxas de resolução poderão diminuir temporariamente até que os solucionadores do CaptchaAI se adaptem.

Devo relatar cada ERROR_CAPTCHA_UNSOLVABLE?

Não. Uma taxa insolúvel de 2–5% é normal para CAPTCHAs complexos. Relate apenas se a taxa exceder 15–20% de forma consistente.

Com que rapidez devo esperar a recuperação das taxas de resolução?

Se o problema for do lado de CaptchaAI, a recuperação normalmente ocorre em poucas horas. Se o site de destino for alterado, talvez seja necessário atualizar seus parâmetros de integração.

Artigos relacionados

• Monitoramento Captcha Solve Rate Sli Slo
• Time Series Captcha resolve tendências de desempenho
• Captcha resolve diagnóstico de queda na taxa de sucesso

Próximas etapas

Mantenha seu pipeline CAPTCHA saudável —obtenha sua chave API CaptchaAI.

Guias relacionados:

• Referência de códigos de erro CaptchaAI
• A qualidade do proxy afeta a taxa de resolução
• Comparativo de tempos de resolução