# YesCaptcha Docs

> O YesCaptcha é uma API de reconhecimento de captcha. Resolva reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF e captchas de imagem com uma única API JSON, com cobrança de pontos por tarefa e reembolso automático de pontos em caso de falha ou timeout.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/pt/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/pt/llms-full.txt

## Primeiros passos

- [Introdução](https://docs.yescaptcha.com/pt/getting-started/introduction.md): O que é o YesCaptcha. Resolva reCAPTCHA, hCaptcha, Turnstile, FunCaptcha e captchas de imagem por API ou extensão do navegador, com cobrança por tarefa e reembolso automático de pontos em caso de falha.
- [Início rápido](https://docs.yescaptcha.com/pt/getting-started/quickstart.md): Faça sua primeira requisição ao YesCaptcha em 5 minutos: cadastre-se, copie a clientKey, faça uma recarga e reconheça um captcha de imagem com curl, Python ou Node.js (ImageToTextTaskOcrBase, resposta síncrona, 2 pontos por imagem).
- [Endpoints](https://docs.yescaptcha.com/pt/getting-started/endpoints.md): Os dois endpoints da API do YesCaptcha: global api.yescaptcha.com e China cn.yescaptcha.com. Aceita apenas HTTPS POST com JSON; crie e consulte a tarefa no mesmo endpoint.
- [Cobrança e reembolso de pontos](https://docs.yescaptcha.com/pt/getting-started/billing.md): Como o YesCaptcha cobra pontos: 1,000 pontos = ¥1, com preço fixo por tipo de tarefa; tarefas com falha ou timeout têm os pontos reembolsados automaticamente, requisições que retornam erro não são cobradas; o saldo precisa ser maior que 10 pontos; reportes de falha no reconhecimento de imagem são reembolsados após cerca de 24 horas.

## Referência da API

- [Requisições e respostas](https://docs.yescaptcha.com/pt/api/overview.md): Convenções gerais da API do YesCaptcha: POST com JSON, autenticação por clientKey, formato de resposta com errorId, tarefas síncronas e assíncronas, consulta a cada 5 segundos, timeout de 110 segundos, resultado guardado por cerca de 10 minutos, idioma das mensagens conforme Accept-Language.
- [createTask — criar tarefa](https://docs.yescaptcha.com/pt/api/create-task.md): POST /createTask cria uma tarefa de captcha. Campos da requisição (clientKey, task, softID), ordem das verificações, tipos assíncronos retornam um taskId e tipos síncronos retornam a solution; o saldo deve ser maior que 10 pontos.
- [getTaskResult – obter o resultado](https://docs.yescaptcha.com/pt/api/get-task-result.md): POST /getTaskResult consulta o resultado de uma tarefa assíncrona. Consulte a cada 5 segundos, continue aguardando em processing, leia solution em ready e pare se houver erro; a tarefa leva no máximo cerca de 110 segundos, o resultado fica guardado por cerca de 10 minutos e a consulta não cobra pontos.
- [getBalance — consultar saldo](https://docs.yescaptcha.com/pt/api/get-balance.md): POST /getBalance consulta o saldo da conta (pontos, 1,000 pontos = ¥1) e os saldos de participação do desenvolvedor e de recompensa por indicação. Não cobra pontos e serve para verificar a clientKey.
- [getSoftID – consultar o ID de desenvolvedor](https://docs.yescaptcha.com/pt/api/get-soft-id.md): POST /getSoftID retorna seu ID de desenvolvedor (softID) e o total acumulado da participação do desenvolvedor; inclua o softID nas requisições createTask feitas quando outras pessoas usam seu software para receber a participação.
- [report — reportar resultados](https://docs.yescaptcha.com/pt/api/report.md): POST /report informa se os resultados das tarefas estavam corretos; reporte sucessos e falhas de forma honesta. Tarefas de reconhecimento de imagem reportadas como falha até 1 hora após a criação têm o reembolso de pontos liquidado após cerca de 24 horas.
- [useragent](https://docs.yescaptcha.com/pt/api/useragent.md): GET https://api.yescaptcha.com/useragent retorna o User-Agent do navegador recomendado no momento (texto simples). O campo userAgent das tarefas de hCaptcha aceita somente esse valor.
- [Códigos de erro](https://docs.yescaptcha.com/pt/api/errors.md): Todos os códigos de erro da API do YesCaptcha, com significado e como tratar cada um: formato da requisição, conta e saldo, tarefas simultâneas e pausa, resultado da tarefa, parâmetros do site, imagens, proxy e servidor. Requisições que retornam erro não são cobradas.
- [Limite de tarefas simultâneas e pausa automática](https://docs.yescaptcha.com/pt/api/rate-limits.md): Limite de tarefas simultâneas do YesCaptcha (ERROR_THREADS_MAXIMUM, sem cobrança de pontos e sem contar para a pausa), pausa automática por excesso de erros (100 em um minuto pausam por 5 minutos, ERROR_IP_BLOCKED_5MIN) e cache de parâmetros inválidos (cached).

## Tipos de tarefa

- [Tipos de tarefa e preços](https://docs.yescaptcha.com/pt/tasks.md): Preços (em pontos; 1,000 pontos = ¥1) e modos de retorno de todos os tipos de tarefa públicos do YesCaptcha. Token para reCAPTCHA, hCaptcha e Turnstile, cookies para a página de desafio do Cloudflare e resultado de reconhecimento para texto em imagem e reconhecimento de imagem.
- [reCAPTCHA v2](https://docs.yescaptcha.com/pt/tasks/recaptcha-v2.md): Obtenha tokens do reCAPTCHA v2 (checkbox, invisível e Enterprise) com o YesCaptcha. Tipos de tarefa e preços, parâmetros da requisição, exemplos em curl/Python/Node.js e o formato do resultado.
- [reCAPTCHA v3](https://docs.yescaptcha.com/pt/tasks/recaptcha-v3.md): Obtenha tokens do reCAPTCHA v3 (incluindo a versão Enterprise) com o YesCaptcha: como preencher pageAction, os tipos com pontuação fixa de 0.7 e 0.9, tipos de tarefa e preços, parâmetros, exemplos e o formato do resultado.
- [hCaptcha](https://docs.yescaptcha.com/pt/tasks/hcaptcha.md): Obtenha tokens do hCaptcha com a YesCaptcha: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 e HCaptchaTask com proxy próprio, como preencher userAgent e rqdata e como usar o respKey retornado.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/pt/tasks/turnstile.md): Obtenha tokens do Cloudflare Turnstile com o YesCaptcha: TurnstileTaskProxyless, TurnstileTaskProxylessM1 e TurnstileTask com proxy próprio, parâmetros, exemplos e formato do resultado, e a diferença em relação à página de desafio do Cloudflare.
- [Página de desafio do Cloudflare](https://docs.yescaptcha.com/pt/tasks/cloudflare-challenge.md): Use o YesCaptcha para passar pela página de verificação "Just a moment..." do Cloudflare e obter cookies como cf_clearance, o User-Agent e o conteúdo da página. Parâmetros de CloudFlareTaskS2 e CloudFlareTaskS3, requisitos de proxy, resultado, como usá-lo e erros comuns.
- [Imagem para texto](https://docs.yescaptcha.com/pt/tasks/image-to-text.md): Leia letras e números em uma imagem com o YesCaptcha. ImageToTextTaskOcrBase e ImageToTextTaskMuggle retornam de forma síncrona; ImageToTextTask e ImageToTextTaskM1 são assíncronos e aceitam maiúsculas/minúsculas, somente números, expressões matemáticas e limite de tamanho; modelos personalizados disponíveis.
- [Reconhecimento de imagem do reCAPTCHA v2](https://docs.yescaptcha.com/pt/tasks/recaptcha-classification.md): 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.
- [Reconhecimento de imagem do hCaptcha](https://docs.yescaptcha.com/pt/tasks/hcaptcha-classification.md): Reconheça os desafios de imagem do hCaptcha com o YesCaptcha (HCaptchaClassification): seleção em grade 3×3, clique em posição indicada, arrastar até a posição indicada e perguntas com animação; resposta síncrona, sem cobrança de pontos quando nenhum alvo é encontrado.
- [Reconhecimento de imagem do FunCaptcha](https://docs.yescaptcha.com/pt/tasks/funcaptcha-classification.md): Reconheça os desafios de imagem do FunCaptcha (Arkose Labs) com o YesCaptcha (FunCaptchaClassification). Envie a imagem do desafio (grade de 6 imagens ou desafio de setas com duas metades) e a pergunta em inglês, e receba de forma síncrona qual imagem escolher; todos os tipos de desafio são suportados.
- [Reconhecimento de imagem AWS WAF / bCaptcha](https://docs.yescaptcha.com/pt/tasks/aws-bcaptcha-classification.md): Reconheça os desafios de imagem em grade 3×3 do AWS WAF CAPTCHA e do bCaptcha com o YesCaptcha (AwsClassification, bCaptchaClassification): envie a imagem inteira e a pergunta e receba, de forma síncrona, as células a clicar.

## Extensão do navegador

- [YesCaptcha Assistant](https://docs.yescaptcha.com/pt/extension.md): YesCaptcha Assistant, a extensão do navegador para Chrome e Firefox que reconhece e clica automaticamente em reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF e outros captchas. A extensão é gratuita; a cobrança de pontos segue as APIs usadas no reconhecimento. Links das lojas, download dos pacotes e vídeos de instalação para Chrome, BitBrowser e Kiwi Browser.

## Guias

- [Identificar o tipo de captcha](https://docs.yescaptcha.com/pt/guides/identify-captcha.md): Como saber qual captcha uma página usa (reCAPTCHA v2, v2 invisível, v3, Enterprise, hCaptcha, Cloudflare Turnstile versus a página de desafio do Cloudflare) e qual tipo de tarefa do YesCaptcha usar.
- [Encontrar os parâmetros do reCAPTCHA](https://docs.yescaptcha.com/pt/guides/find-recaptcha-parameters.md): Como encontrar o websiteKey (sitekey), o websiteURL, o pageAction do v3 e a função de callback do reCAPTCHA nos painéis Network, Sources e Console das ferramentas do desenvolvedor, com um script de busca automática.
- [Encontrar os parâmetros do hCaptcha](https://docs.yescaptcha.com/pt/guides/find-hcaptcha-parameters.md): Como encontrar o websiteKey (sitekey), o websiteURL e o rqdata da versão Enterprise do hCaptcha: pesquise data-sitekey no código-fonte da página ou procure as requisições checksiteconfig e getcaptcha na aba Network.
- [Encontrar os parâmetros do Turnstile](https://docs.yescaptcha.com/pt/guides/find-turnstile-parameters.md): Como encontrar o websiteKey (sitekey, começa com 0x) e o websiteURL do Cloudflare Turnstile: busque data-sitekey ou turnstile.render no código-fonte da página, ou veja as requisições para challenges.cloudflare.com na aba Network.
- [Usar o token para concluir o reCAPTCHA](https://docs.yescaptcha.com/pt/guides/submit-recaptcha-token.md): O que fazer com o token do reCAPTCHA (gRecaptchaResponse) depois de obtê-lo: como funciona, envio direto por requisição (campo g-recaptcha-response) e preenchimento no navegador com chamada da função de callback, com exemplos completos em Python na página de demonstração do Google.
- [Cliques em imagens do reCAPTCHA com Selenium](https://docs.yescaptcha.com/pt/guides/recaptcha-click-selenium.md): Use Python, Selenium 4 e ReCaptchaV2Classification para clicar nos desafios de imagem do reCAPTCHA v2 em um navegador real. Dispare o captcha, leia a pergunta e a imagem, chame a API, clique nos quadrados e envie; código de exemplo completo.
- [Clique em imagens do hCaptcha com Selenium](https://docs.yescaptcha.com/pt/guides/hcaptcha-click-selenium.md): Use Python, Selenium 4 e HCaptchaClassification para resolver desafios de imagens em grade 3×3 do hCaptcha em um navegador real. Clique na caixa de seleção, leia a pergunta e as 9 imagens, chame a API, clique e envie; código de exemplo completo.

## Exemplos de código

- [Exemplos de código e SDKs](https://docs.yescaptcha.com/pt/samples.md): Exemplos de código executáveis do YesCaptcha (Python, Node.js, curl, C#, Easy Language) e SDKs não oficiais da comunidade (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/pt/samples/python.md): Exemplos em Python do YesCaptcha: consultar o saldo, reconhecer um captcha de imagem, uma classe de cliente reutilizável (cria a tarefa e consulta periodicamente a cada 5 segundos), controle de tarefas simultâneas com asyncio e envio de reCAPTCHA com requests e Selenium.
- [Node.js](https://docs.yescaptcha.com/pt/samples/nodejs.md): Exemplos de Node.js para o YesCaptcha (Node.js 18+, com o fetch nativo, sem bibliotecas de terceiros): consultar o saldo, reconhecer um captcha de imagem e uma classe de cliente reutilizável (criar tarefa, consultar a cada 5 segundos).
- [C#](https://docs.yescaptcha.com/pt/samples/csharp.md): Exemplo em C# do YesCaptcha (.NET 6+, HttpClient + System.Text.Json): consulta o saldo, cria uma tarefa reCAPTCHA v2 e consulta o resultado a cada 5 segundos.
- [Easy Language](https://docs.yescaptcha.com/pt/samples/easy-language.md): Exemplos de YesCaptcha em Easy Language contribuídos por usuários. Cliques simulados em reCAPTCHA e hCaptcha, reconhecimento de imagem do FunCaptcha e envio de token do reCAPTCHA; pacotes para download e pontos principais para chamar a API.

## Conta

- [Várias clientKeys: limite de gastos, IPs permitidos e expiração](https://docs.yescaptcha.com/pt/account/client-keys.md): Uma conta YesCaptcha pode ter até 20 clientKeys, todas usando o mesmo saldo da conta. Cada uma pode ter seu próprio limite de gastos (por dia, semana ou mês, ou um total único, zerado no horário de Pequim), IPs permitidos e data de expiração, com efeito em poucos segundos.
- [Recarga e VIP](https://docs.yescaptcha.com/pt/account/recharge.md): Como recarregar o YesCaptcha (WeChat Pay, Alipay, PayPal, criptomoedas); 1,000 pontos = ¥1. A recarga acumulada eleva automaticamente seu nível de VIP 1 a VIP 10, e cada recarga seguinte recebe pontos de bônus proporcionais.
- [Recompensa por indicação](https://docs.yescaptcha.com/pt/account/referral.md): Programa de indicação do YesCaptcha. Quem você indica recebe um nível VIP ao se cadastrar (seu nível menos 1, de VIP 1 a VIP 6), e você recebe 20% do valor que a pessoa gastar (10% para cada um quando também há participação do desenvolvedor), que pode virar saldo ou ser sacado a partir de ¥100 no Painel.
- [Participação do desenvolvedor](https://docs.yescaptcha.com/pt/account/developer.md): Participação do desenvolvedor no YesCaptcha. Inclua seu softID nas requisições que seu software envia em nome dos usuários e receba 20% do valor que eles gastam (10% para cada parte quando também há um indicador); converta em saldo ou saque a partir de ¥100 no painel.

## Ajuda

- [Perguntas frequentes](https://docs.yescaptcha.com/pt/help/faq.md): Perguntas frequentes sobre o YesCaptcha. Se tarefas com falha são cobradas, por quanto tempo o token é válido, taxa de aprovação, reconhecimento humano ou por máquina, banimento de conta, uso de uma clientKey em vários lugares, qual endpoint usar, extensão vs API.
- [Problemas de conexão e rede](https://docs.yescaptcha.com/pt/help/troubleshooting.md): O que fazer quando não é possível acessar a API do YesCaptcha. Failed to establish a new connection, falha de DNS, interferência de software de proxy e erros de SSL (Certificate has expired, SSLEOFError).
- [Fale conosco](https://docs.yescaptcha.com/pt/help/contact.md): Entre em contato com o suporte do YesCaptcha por WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official ou e-mail yescaptcha@gmail.com, das 9:00 às 21:00 (UTC+8).
- [Registro de alterações do serviço](https://docs.yescaptcha.com/pt/changelog.md): Mudanças do YesCaptcha que afetam os usuários, por data: tipos de tarefa lançados e desativados, regras de cobrança e de reembolso de pontos, limite de tarefas simultâneas e migração da documentação. Registrado a partir de outubro de 2026.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)