
Adélia Cruz
MCP Integration Engineer
Publicado Oct 22, 2026
Atualizado Oct 22, 2026 · minutos de leitura

ImageToTextTask da CapSolver aceita dados de imagem e retorna diretamente o texto reconhecido; uma tarefa de token de reCAPTCHA usa parâmetros do site e tem um contrato de resultado diferente.Escolher entre reconhecimento de imagem de CAPTCHA e resolução por token começa com uma pergunta prática: o que a próxima etapa da sua aplicação espera? Um campo de texto pode precisar dos caracteres exibidos em uma imagem. Uma integração de reCAPTCHA espera um token de resposta. Enviar o primeiro resultado para a segunda interface não vai funcionar, mesmo que ambas as operações sejam descritas como “resolver um CAPTCHA”.
A CapSolver documenta tarefas de reconhecimento e de token separadas. Este guia compara suas entradas, saídas e responsabilidades de integração para que você possa escolher um ponto de partida adequado para testes ou automação autorizados. Ele não classifica provedores nem assume que todo CAPTCHA pode ser tratado pela mesma requisição.
O reconhecimento de imagem produz uma resposta sobre o conteúdo da imagem, enquanto a resolução por token produz um valor de resposta para um sistema de verificação compatível.
Essas são distinções em nível de API. Elas não definem qual modelo subjacente um serviço usa ou se um navegador é envolvido internamente. Para o trabalho de integração, a distinção útil é a informação que você envia e o resultado que recebe.
Um CAPTCHA pode ter diversas formas visíveis. Alguns pedem para a pessoa ler caracteres distorcidos; outros exibem um desafio de seleção de imagens; outros ainda funcionam sem um quebra‑cabeça de imagem. A presença de uma imagem, por si só, não indica o que a aplicação aceitará como conclusão.
| Ponto de decisão | Reconhecimento de imagem | Resolução por token |
|---|---|---|
| Entrada típica | Bytes de imagem codificados como texto, mais instruções específicas da tarefa | URL do site, chave do site e parâmetros específicos da tarefa |
| Saída típica | Caracteres reconhecidos ou resultados de classificação | Um token de resposta de CAPTCHA |
| O que o chamador deve fornecer | A imagem correta para o desafio atual | O tipo correto de CAPTCHA e os parâmetros atuais da página |
| O que permanece depois | Usar a resposta na etapa pretendida da aplicação e verificar a aceitação | Entregar o token pela integração pretendida e verificar a aceitação |
| Incompatibilidade comum | Tratar a saída de classificação como token de verificação | Enviar um token para um campo que espera caracteres de imagem |
Essa comparação descreve contratos de tarefa comuns, não um esquema universal. Leia a documentação da tarefa exata antes de construir um parser de resultados compartilhado.
Escolha reconhecimento de imagem quando seu fluxo de trabalho tem uma imagem e precisa de uma resposta definida sobre seu conteúdo.
Por exemplo, um teste autorizado de uma aplicação com CAPTCHA de texto pode já ter acesso à imagem exibida. A próxima etapa espera seus caracteres. Uma tarefa de OCR pode fornecer esse texto, enquanto o teste da aplicação permanece responsável por inseri‑lo e verificar o resultado.
A referência oficial da tarefa ImageToText exige um body contendo o conteúdo da imagem codificado em Base64. Uma URL de site é opcional para essa tarefa. Fornecer uma site key sem a imagem não satisfaz esse requisito de entrada.
Base64 representa dados binários usando caracteres de texto. É uma codificação, não uma etapa de melhoria de imagem. Um CAPTCHA mal recortado ou desatualizado continua inadequado após a codificação.
Para ImageToTextTask, use o conteúdo da imagem sem quebras de linha ou o prefixo data:image/...;base64,, como especifica a referência da tarefa. Mantenha conteúdo de página não relacionado e informações pessoais fora da imagem enviada ao serviço.
O corpo de requisição a seguir segue o esquema oficial com um espaço reservado explícito para a imagem. É um exemplo de esquema, não uma solução executada: substitua a chave e o valor da imagem antes de usá‑lo com POST https://api.capsolver.com/createTask.
{
"clientKey": "SUA_API_KEY",
"task": {
"type": "ImageToTextTask",
"body": "CONTEUDO_DA_IMAGEM_EM_BASE64"
}
}
Essa tarefa retorna seu resultado de reconhecimento diretamente. Inspecione os campos de erro antes de ler solution.text; não adicione um loop de polling só porque outra tarefa de CAPTCHA precisa de um.
A classificação de imagem responde a uma pergunta sobre uma imagem em vez de transcrever caracteres. A CapSolver documenta a classificação de imagem de reCAPTCHA como uma tarefa separada com entradas de imagem e pergunta.
Uma resposta de classificação não é uma verificação de reCAPTCHA concluída. Se você escolher uma interface de reconhecimento, sua aplicação ainda precisa de um fluxo de desafio compatível. Não presuma que uma lista de regiões de imagem selecionadas pode ser inserida em qualquer lugar onde a aplicação espera um token de resposta.
Para uma primeira integração, escreva o resultado esperado antes de escolher um nome de tarefa. “Ler os caracteres” e “obter uma resposta de reCAPTCHA” são requisitos diferentes, mesmo quando ambos começam com uma captura de tela em um ticket de suporte.
Escolha resolução por token quando a aplicação usa uma integração de CAPTCHA compatível e a saída exigida é seu token de resposta.
A referência da tarefa reCAPTCHA v2 descreve parâmetros do site como websiteURL e websiteKey. Eles identificam a página e a integração de CAPTCHA. Não são substitutos um do outro, e a site key pública não é sua chave de API da CapSolver.
Este segundo exemplo de esquema mostra o formato básico de uma tarefa reCAPTCHA v2 “proxyless”. Não é uma requisição executada e não inclui todos os parâmetros opcionais de que uma integração específica pode precisar.
{
"clientKey": "SUA_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.seusite.com",
"websiteKey": "SUA_RECAPTCHA_SITE_KEY"
}
}
Use os valores reais da página permitida e o tipo de tarefa documentado para aquela versão de CAPTCHA. Uma integração v2, v3 ou Enterprise não deve ser selecionada por tentativa e erro com nomes de tarefas não relacionados.
Com o fluxo assíncrono createTask, salve o ID da tarefa retornado e obtenha o resultado dessa tarefa através de getTaskResult. Leia o campo de solução documentado para a tarefa selecionada. Evite escrever um parser único que pressuma que toda resposta bem‑sucedida contém o mesmo campo.
Resgate seu Código de Bônus da CapSolver
Impulsione seu orçamento de automação instantaneamente!
Use o código de bônus CAP26 ao recarregar sua conta CapSolver para obter 5% de bônus extra em cada recarga — sem limites.
Resgate agora no seu Painel CapSolver
Ambos os fluxos de trabalho precisam de uma verificação em nível de aplicação depois que o solver retorna seu resultado.
Para um CAPTCHA de texto, isso pode significar confirmar que o formulário pretendido aceitou os caracteres para o mesmo desafio. Se a imagem tiver sido atualizada enquanto a requisição estava em execução, uma resposta para a imagem anterior já não é o resultado de que seu formulário atual precisa.
Para integrações por token, uma string não vazia não comprova que a aplicação aceitou a requisição. A documentação de verificação do reCAPTCHA do Google descreve a etapa de verificação do token no servidor do site. O segredo privado de verificação do site pertence ao seu servidor; um usuário de solver não deveria precisar obter o segredo de outra pessoa.
Da mesma forma, a Cloudflare exige validação no servidor das respostas do Turnstile. Essas verificações do provedor são separadas do solver informar que uma tarefa está pronta. Se você opera a aplicação, inspecione o resultado da validação. Se estiver testando outro fluxo permitido, verifique o resultado de sucesso documentado sem alegar visibilidade do backend privado.
A distinção também ajuda na depuração. Registre se a falha ocorreu durante a captura da imagem, criação da tarefa, recuperação do resultado, entrega do resultado ou aceitação pela aplicação. Uma captura de tela apenas do erro final pode não identificar qual etapa precisa de atenção.
Para mais detalhes sobre valores retornados, veja a explicação sobre tokens e cookies de CAPTCHA. Nem uma resposta de OCR nem um token de resposta estabelecem automaticamente uma sessão de navegador persistente.
Escolha a menor interface compatível que forneça o resultado que seu fluxo de trabalho existente pode consumir.
Use uma tarefa de reconhecimento de texto quando o desafio for uma imagem de texto e você puder obter legitimamente a imagem atual. Confirme a captura da imagem, a codificação, o texto retornado e a resposta do formulário como etapas separadas. Isso se encaixa diretamente em OCR; adicionar uma tarefa de token de site não atenderia ao requisito do campo de entrada.
Use a tarefa de token correspondente quando você tiver os parâmetros documentados e um caminho de integração legítimo. Não transforme a presença de um quebra‑cabeça de imagem em um requisito de manter um fluxo de trabalho separado de classificação de imagem. Comece pelo produto de CAPTCHA e pelo contrato de resposta.
Faça o agente identificar o desafio compatível e o contexto de integração disponível antes de solicitar uma ação ao solver. Uma captura de tela por si só não prova que o agente tem a entrada de imagem certa, a site key, o callback ou o caminho de entrega do resultado. Interrompa em caso de informações ausentes em vez de deixar o modelo inventar valores.
Para um fluxo de trabalho de navegador estabelecido, uma integração de navegador documentada pode tratar mais dessa interação. A comparação deste guia não substitui um teste de integração com o cliente ou navegador específico que você pretende usar.
Compare compatibilidade, esforço de implementação e resultados verificados na aplicação antes de comparar o preço destacado de tarefas individuais.
Compatibilidade vem em primeiro lugar: uma resposta de baixo custo não é útil se tiver o formato errado para a aplicação. Em seguida, considere o trabalho que sua equipe deve manter, como captura de imagem, estado do desafio, recuperação do resultado e verificações finais de aceitação. Essas responsabilidades diferem entre fluxos de trabalho mesmo quando ambos usam uma API HTTP.
Avalie uma pequena amostra autorizada que reflita o tipo de CAPTCHA de que você realmente precisa. Mantenha as condições de origem consistentes o suficiente para entender as falhas. Registre erros de tarefa e rejeição da aplicação separadamente, e evite tratar o status “pronto” de um provedor como sua taxa de sucesso ponta a ponta.
Não infira velocidade, precisão de reconhecimento ou superioridade de custo apenas desta classificação. Esses são valores medidos para uma tarefa e integração específicas, não consequências das palavras “imagem” ou “token”.
A resposta esperada oferece o ponto de partida mais claro: caracteres de imagem, saída de classificação ou um token de resposta de verificação.
Verifique essa resposta em relação à documentação atual da tarefa, forneça as entradas correspondentes e defina como sua aplicação confirmará a conclusão. A CapSolver fornece interfaces separadas para essas necessidades; escolher de forma deliberada reduz incompatibilidades evitáveis de entrada e saída.
Experimente a CapSolver com um tipo de CAPTCHA compatível em um fluxo de trabalho autorizado. Comece com um contrato de tarefa confirmado antes de expandir sua implementação.
P: O reconhecimento de imagem de CAPTCHA é o mesmo que resolução por token?
Não. O reconhecimento retorna informações sobre uma imagem, como texto ou resultados de classificação. A resolução por token retorna uma resposta para uma integração de CAPTCHA compatível. Selecione a interface com base no que a aplicação espera em seguida.
P: Um resultado de OCR pode ser usado como token de reCAPTCHA?
Não. Caracteres reconhecidos não são um token de resposta de reCAPTCHA. Eles pertencem a contratos de entrada e verificação diferentes.
P: Toda tarefa de CAPTCHA precisa de polling?
Não. A CapSolver documenta resultado direto para ImageToTextTask, enquanto tarefas assíncronas de token usam um ID de tarefa e recuperação de resultado. Siga o fluxo documentado para a tarefa selecionada em vez de aplicar um único loop a todas as respostas.
P: Qual método é melhor para um agente de IA?
O melhor método é aquele que corresponde ao desafio e à integração real do agente. Um agente que consegue capturar uma imagem não é automaticamente capaz de concluir um fluxo de trabalho baseado em token. Verifique as entradas exigidas e a etapa de entrega do resultado.
P: Uma resposta bem-sucedida do solver significa que minha aplicação teve sucesso?
Não. A aplicação ainda precisa aceitar a resposta ou o token e concluir a ação pretendida. Verifique esse resultado separadamente e mantenha a automação dentro do acesso que você está autorizado a usar.

Adélia Cruz
MCP Integration Engineer
Making CapSolver tools accessible through MCP.
SOBRE O AUTOR
Corrija o erro ERROR_IP_BANNED interrompendo solicitações repetidas e inválidas à API de CAPTCHA, encontrando o primeiro erro, verificando os códigos relacionados e retomando com um teste controlado.

Solucione erros de proxy do CapSolver verificando os parâmetros da tarefa, a autenticação, a conectividade e as configurações de sessão antes de tentar novamente uma solicitação de CAPTCHA.
