Perguntas frequentes

O YesCaptcha cobra pontos quando falha ao resolver um captcha?

Não. Tarefas com falha (ERROR_CAPTCHA_UNSOLVABLE) e com tempo esgotado (ERROR_TASK_TIMEOUT) têm os pontos devolvidos automaticamente, e requisições que retornam um código de erro, como as de parâmetros inválidos, não são cobradas. Se você obteve o token mas o site de destino não o aceitou, a tarefa é cobrada como bem-sucedida, pois não temos como saber a decisão do site; nos tipos de reconhecimento de imagem, é possível reportar cliques errados para solicitar o reembolso de pontos. Veja Cobrança e reembolso de pontos.

Quanto custa cada reconhecimento?

Cada tipo de tarefa tem um preço fixo em pontos (1 ¥ = 1,000 pontos), e os preços variam conforme o tipo. Todos os preços estão em Tipos de tarefa e preços; a versão legível por máquina está em /data/task-types.json.

Por quanto tempo o token é válido?

Os tokens de reCAPTCHA, hCaptcha e Turnstile são de uso único. O token do reCAPTCHA é válido por cerca de 120 segundos; recomendamos enviá-lo em até 60 segundos após recebê-lo. O prazo de validade é definido pelo fornecedor do captcha.

Por que às vezes o token obtido não é aprovado?

Quem decide se o token é aprovado é o site de destino. O site avalia pontuação, IP, ambiente do navegador e outros fatores, e o critério pode mudar a qualquer momento, por isso a taxa de aprovação varia de site para site. Você pode comparar outros tipos de tarefa para o mesmo captcha, usar um tipo com proxy próprio e enviar o token pelo mesmo proxy, ou usar o reconhecimento de imagem e clicar de verdade no navegador.

Quanto tempo leva o reconhecimento?

As tarefas assíncronas costumam levar de alguns segundos a algumas dezenas de segundos, no máximo cerca de 110 segundos (180 a 220 segundos em alguns tipos); depois disso, expiram e os pontos são devolvidos automaticamente. O reconhecimento de imagem e o de texto em imagem são síncronos e retornam em uma única requisição.

O reconhecimento é feito por humanos ou por máquina?

Por máquina, com modelos de aprendizado de máquina.

Usar o YesCaptcha pode levar ao banimento da minha conta?

Só retornamos o resultado do reconhecimento e não temos acesso à sua conta no site de destino. Como o site avalia a atividade e se bane contas é decisão do próprio site; siga as regras dele. O YesCaptcha só pode ser usado para fins legais, e o uso ilegal é proibido.

Uma clientKey pode ser usada em vários programas e navegadores ao mesmo tempo?

Sim. As requisições de uma mesma conta somam-se no limite de tarefas simultâneas e compartilham o mesmo saldo.

Devo usar o endpoint global ou o endpoint China?

Para servidores na China continental, use cn.yescaptcha.com; nas demais regiões, use api.yescaptcha.com. Consulte o resultado no mesmo endpoint em que a tarefa foi criada. Veja Endpoints.

Qual é a diferença entre a extensão do navegador e a API?

A extensão também usa a mesma API para reconhecer captchas. Ela é de instalação gratuita, cobra pontos pelas chamadas de API que usa e é indicada para quem trabalha no navegador sem escrever código; a API é indicada para processamento em lote em programas. Veja Extensão do navegador.

Por que fui pausado com ERROR_IP_BLOCKED_5MIN?

A mesma clientKey gerou requisições com erro demais em um minuto e foi pausada automaticamente por alguns minutos; ao fim do prazo, volta ao normal sozinha. O campo blockReason na resposta indica o código de erro que causou a pausa; corrija seu programa de acordo com ele. Veja Limite de tarefas simultâneas e pausa automática.

Quais sites são compatíveis?

Oferecemos reconhecimento por tipo de captcha, não por site específico. Se é possível passar depende das configurações do site de destino, por isso recomendamos testar primeiro com um lote pequeno. Quando um site ainda não é compatível, a resposta é ERROR_DOMAIN_NOT_ALLOWED.