# Reconhecimento de imagem do reCAPTCHA v2

> Reconheça os desafios de imagem do reCAPTCHA v2 com o YesCaptcha (ReCaptchaV2Classification): envie uma imagem 3x3, 4x4 ou 1x1 com o ID da pergunta e receba de forma síncrona as células a clicar; preço por tamanho da imagem, tabela de IDs de perguntas.

Source: https://docs.yescaptcha.com/pt/tasks/recaptcha-classification/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/tasks/recaptcha-classification/

`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](https://docs.yescaptcha.com/pt/extension.md), que clica automaticamente com base nesta mesma API.

- POST `https://api.yescaptcha.com/createTask` (Endpoint global)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint China)

## 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

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

## Resultado

3x3 e 4x4:

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

Imagem pequena 1x1:

```json
{
  "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:

![Numeração das células de 0 a 8 da grade 3x3](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![Numeração das células de 0 a 15 da grade 4x4](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## 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` |

Nenhuma pergunta correspondente

`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](https://docs.yescaptcha.com/pt/api/report.md) 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](https://docs.yescaptcha.com/pt/getting-started/billing.md). Quando a verificação for aprovada, reporte também com `isSuccess: true`.

## Tutoriais relacionados

-   [Reconhecimento de imagem do reCAPTCHA v2 com cliques simulados (Selenium)](https://docs.yescaptcha.com/pt/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2 (retorna token)](https://docs.yescaptcha.com/pt/tasks/recaptcha-v2.md)