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.