Tutoriais de API

Resolva CAPTCHA de imagem com Node.js e CaptchaAI

Image CAPTCHAs exibem texto distorcido que os usuários devem digitar. Eles aparecem em sites governamentais, formulários legados e páginas de registro.CaptchaAIlê a imagem e retorna o texto. Este guia mostra como fazer isso em Node.js.


Pré-requisitos

Artigo Valor
Chave de API CaptchaAI Decaptchaai.com
Node.js 14+
Bibliotecas axios, fs
Formato de imagem JPG, PNG ou GIF (100 bytes – 100 KB)

Método A: envio Base64

const axios = require('axios');
const fs = require('fs');

const API_KEY = 'YOUR_API_KEY';
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

// Read and encode the image
const imageB64 = fs.readFileSync('captcha.png').toString('base64');

// Submit to CaptchaAI
const { data: submitData } = await axios.post('https://ocr.captchaai.com/in.php', null, {
  params: {
    key: API_KEY,
    method: 'base64',
    body: imageB64,
    json: 1,
  },
});

if (submitData.status !== 1) throw new Error(submitData.request);
const taskId = submitData.request;
console.log(`Task submitted: ${taskId}`);

Método B: upload de arquivo

const FormData = require('form-data');

const form = new FormData();
form.append('key', API_KEY);
form.append('method', 'post');
form.append('json', '1');
form.append('file', fs.createReadStream('captcha.png'));

const { data: submitData } = await axios.post('https://ocr.captchaai.com/in.php', form, {
  headers: form.getHeaders(),
});

const taskId = submitData.request;

Enquete para o resultado do texto

await sleep(5000);

let captchaText;
for (let i = 0; i < 30; i++) {
  const { data: pollData } = await axios.get('https://ocr.captchaai.com/res.php', {
    params: { key: API_KEY, action: 'get', id: taskId, json: 1 },
  });

  if (pollData.status === 1) {
    captchaText = pollData.request;
    console.log(`CAPTCHA text: ${captchaText}`);
    break;
  }
  if (pollData.request !== 'CAPCHA_NOT_READY') {
    throw new Error(pollData.request);
  }
  await sleep(5000);
}

Parâmetros de precisão

// Digits only, 4-6 characters
const { data } = await axios.post('https://ocr.captchaai.com/in.php', null, {
  params: {
    key: API_KEY,
    method: 'base64',
    body: imageB64,
    numeric: 1,      // digits only
    min_len: 4,       // minimum length
    max_len: 6,       // maximum length
    json: 1,
  },
});
Parâmetro Valor Objetivo
numeric 1 = dígitos, 2 = letras Limita caracteres
min_len / max_len Inteiro Restrições de comprimento
calc 1 Calcula expressão matemática
regsense 1 Diferencia maiúsculas de minúsculas

Exemplo de trabalho completo

const axios = require('axios');
const puppeteer = require('puppeteer');
const fs = require('fs');

const API_KEY = 'YOUR_API_KEY';
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function solveImageCaptcha() {
  // 1. Load page and screenshot CAPTCHA
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com/register');

  const captchaEl = await page.$('#captcha-image');
  await captchaEl.screenshot({ path: 'captcha.png' });

  // 2. Encode and submit
  const imageB64 = fs.readFileSync('captcha.png').toString('base64');
  const { data: submit } = await axios.post('https://ocr.captchaai.com/in.php', null, {
    params: { key: API_KEY, method: 'base64', body: imageB64, json: 1 },
  });
  const taskId = submit.request;

  // 3. Poll for text
  await sleep(5000);
  let text;
  for (let i = 0; i < 30; i++) {
    const { data: poll } = await axios.get('https://ocr.captchaai.com/res.php', {
      params: { key: API_KEY, action: 'get', id: taskId, json: 1 },
    });
    if (poll.status === 1) { text = poll.request; break; }
    if (poll.request !== 'CAPCHA_NOT_READY') throw new Error(poll.request);
    await sleep(5000);
  }

  // 4. Type and submit
  await page.type('#captcha-input', text);
  await page.click('form [type="submit"]');
  console.log(`Solved: ${text}`);
  await browser.close();
}

solveImageCaptcha().catch(console.error);

Resultado esperado:

Solved: ABC123

Erros comuns

Erro Causa Correção
ERROR_WRONG_FILE_EXTENSION Formato não suportado Usar JPG, PNG ou GIF
ERROR_TOO_BIG_CAPTCHA_FILESIZE Imagem > 100 KB Comprimir primeiro
ERROR_ZERO_CAPTCHA_FILESIZE Imagem <100 bytes Verifique a imagem
CAPCHA_NOT_READY Ainda resolvendo Enquete a cada 5 segundos

Perguntas frequentes

Posso resolver CAPTCHAs matemáticos?

Sim. Adicione calc: 1 aos parâmetros e CaptchaAI retornará o resultado calculado.

Como faço para relatar soluções erradas?

Ligue para https://ocr.captchaai.com/res.php?key=KEY&action=reportbad&id=TASK_ID para relatar resultados incorretos.

O base64 ou o upload de arquivos são com menor latência?

O desempenho é o mesmo. Base64 é mais conveniente quando você já tem a imagem na memória.


Guias relacionados


Comece a resolver CAPTCHAs de imagem com CaptchaAI →

Os comentários estão desativados para este artigo.