Reconhecimento de imagem do reCAPTCHA v2

ReCaptchaV2Classification reconhece os desafios de imagem exibidos pelo reCAPTCHA v2: você envia a imagem e o ID da pergunta, e recebe quais células devem ser clicadas; o clique é feito pelo seu programa no navegador. Ele não retorna token. A resposta é síncrona: uma única requisição createTask já traz o resultado. Cada imagem 3x3 ou 4x4 custa 6 pontos (≈ US$0.90 / 1k), e a imagem pequena 1x1 é mais barata (veja a tabela abaixo).

Dica

Se não quiser escrever a lógica de clique, use a extensão do navegador, que clica automaticamente com base nesta mesma API.

POSThttps://api.yescaptcha.com/createTaskEndpoint globalCopiar

POSThttps://cn.yescaptcha.com/createTaskEndpoint ChinaCopiar

Tipos e preços

Tipo de tarefa	Preço	Modo	Observações
ReCaptchaV2Classification	US$0.90 / 1k; 6 pontos/tarefa · ¥6 / 1k	Síncrono	2 pontos para uma peça 1x1 (100x100); 6 pontos para 3x3 (300x300) e 4x4 (450x450)

Os preços em dólares americanos são estimativas com base em US$1 ≈ ¥6.67; as tarefas são cobradas em pontos.

Parâmetros da requisição

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Tipo de tarefa; veja "Tipos de tarefa e preços" nesta página
image	string	Sim	Imagem do desafio codificada em Base64, sem o prefixo data:
question	string	Sim	ID da pergunta, como /m/0k4j; veja "IDs de perguntas" nesta página
confidence	number	Não	Limite de confiança de 0 a 1, usado apenas em imagens 3x3. Se informado (0.5 é um bom ponto de partida), todas as células acima desse valor são retornadas; se omitido, as 3 células mais prováveis são retornadas

Cuidado

A imagem deve ser redimensionada para um dos tamanhos padrão da tabela abaixo; o servidor identifica o tipo de desafio pelo tamanho.

Tipo de desafio	Tamanho da imagem	Retorno
Grade 3x3 (“Select all images with …”)	300 × 300	objects: células a clicar
Grade 4x4 (“Select all squares with …”)	450 × 450	objects: células a clicar
Imagem pequena 1x1 (imagem única que aparece após clicar na grade 3x3)	100 × 100	hasObject: se esta imagem deve ser clicada

Se você trabalha com capturas de tela, identifique o tipo pelo texto da pergunta: a 3x3 diz “Select all images with …” e a 4x4 diz “Select all squares with …”.

Exemplo de requisição

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

Resultado

3x3 e 4x4:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [1, 5, 8],
    "type": "multi"
  },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

Imagem pequena 1x1:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "hasObject": true,
    "type": "single"
  }
}

Campo	Tipo	Descrição
objects	array	Índices das imagens a clicar, começando em 0, da esquerda para a direita e de cima para baixo
hasObject	boolean	Retornado para uma imagem 1x1; indica se a imagem contém o alvo
type	string	Tipo de desafio: multi (imagem 3x3 ou 4x4, veja objects), single (imagem 1x1, veja hasObject); drag para perguntas de arrastar do hCaptcha

As células são numeradas a partir de 0, da esquerda para a direita e de cima para baixo:

confidence: receber de uma vez todas as células que correspondem

Depois que você clica na grade 3x3, normalmente aparecem imagens pequenas 1x1 que também precisam ser avaliadas. Se for difícil capturar essas imagens (por exemplo, em desenvolvimento para celular), envie confidence:

• Sem confidence, a imagem 3x3 retorna as 3 células com maior pontuação (o reCAPTCHA exige pelo menos 3 cliques).
• Com confidence (recomendado 0.5), retorna todas as células com pontuação acima desse valor, que podem ser mais ou menos de 3; se nenhuma corresponder, retorna um array vazio. Assim você não precisa mais capturar as imagens 1x1.
• Não tem efeito em imagens 4x4 e 1x1.

IDs de perguntas

Em question, informe o ID da pergunta (começa com /m/), não o texto. O ID vem junto com a imagem na resposta da requisição que o reCAPTCHA usa para carregar o desafio (reload ou userverify). A tabela abaixo lista as perguntas mais comuns; o texto em chinês serve apenas de referência:

16 no total

ID da pergunta	Pergunta (inglês)
/m/0pg52	taxis
/m/01bjv	bus
/m/04_sv	motorcycles
/m/013xlm	tractors
/m/01jk_4	chimneys
/m/014xcs	crosswalks
/m/015qff	traffic lights
/m/0199g	bicycles
/m/015qbp	parking meters
/m/0k4j	cars
/m/015kr	bridges
/m/019jd	boats
/m/0cdl1	palm trees
/m/09d_r	mountains or hills
/m/01pns0	fire hydrant
/m/01lynh	stairs

ERROR_UNKNOWN_QUESTION indica que o ID está errado ou que a pergunta ainda não é suportada. ERROR_UNKNOW_450x450_QUESTION indica que a pergunta ainda não é suportada em imagens 4x4; basta recarregar o desafio na página para obter outra.

Reportar e reembolso de pontos

Se a verificação falhar após o clique, você pode reportar com report em até 1 hora; o reembolso de pontos é liquidado após cerca de 24 horas. As regras estão em Cobrança e reembolso de pontos. Quando a verificação for aprovada, reporte também com isSuccess: true.

Tutoriais relacionados

• Reconhecimento de imagem do reCAPTCHA v2 com cliques simulados (Selenium)
• reCAPTCHA v2 (retorna token)