
Adélia Cruz
MCP Integration Engineer
Publicado Nov 05, 2026
Atualizado Nov 05, 2026 · minutos de leitura

Os clientes do VisionEngine precisam tomar duas decisões em conjunto. O módulo selecionado determina quais imagens a requisição descreve e qual resultado a aplicação deve esperar. Um parser que assume que toda tarefa de imagem retorna texto irá descartar um resultado válido de rotação ou distância.
A CapSolver documenta os campos de requisição e resposta abordados neste guia.
Comece com as capturas de tela e exemplos de requisição na tabela oficial de módulos. Para um layout de rotação que corresponda ao exemplo rotate_1, a requisição documentada contém uma imagem de primeiro plano e uma imagem de fundo. O exemplo slider_1 também contém ambos os campos, mas sua saída representa distância. Mantenha cada imagem capturada associada ao seu papel original. Referência da API VisionEngine
Revise o exemplo do módulo específico antes de tratar a tabela geral de parâmetros como um esquema de requisição universal. Prepare apenas as imagens exigidas para o desafio autorizado em teste. Remova o prefixo de data URL e as quebras de linha ao preparar os campos Base64 documentados.
A referência do VisionEngine documenta uma resposta síncrona para createTask. Verifique os campos de erro antes de ler solution. Depois verifique o formato de solution em relação ao módulo que você enviou. Para rotate_1, o exemplo publicado contém angle. Para slider_1, ele contém distance. Mantenha o nome do campo e o módulo juntos ao repassar o resultado para o código da aplicação. Referência de criação de tarefa
Resgate Seu Código de Bônus CapSolver
Aumente 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 em seu Painel CapSolver
Registre o módulo, o status da resposta e se o campo de solução esperado estava presente. Se o campo estiver ausente, compare o módulo enviado e o layout da imagem com seu exemplo de referência antes de alterar o parser. Em um ambiente de teste próprio, registre a aceitação da aplicação separadamente do resultado de reconhecimento. Para erros de serviço, use o código de erro documentado como ponto de partida. Códigos de erro da API
Use a CapSolver com o contrato de requisição documentado e verifique o resultado na aplicação separadamente.
P: Devo fazer polling em getTaskResult para o VisionEngine?
A documentação do VisionEngine descreve o resultado como parte da resposta de createTask.
P: Posso usar um único parser de resultado para todos os módulos?
Você pode compartilhar o tratamento de erros. Valide o formato de solution separadamente para cada módulo compatível.
P: O que devo inspecionar primeiro se o resultado parecer incorreto?
Compare o layout do desafio, o módulo selecionado e os papéis das imagens com o exemplo oficial correspondente.

Adélia Cruz
MCP Integration Engineer
Making CapSolver tools accessible through MCP.
SOBRE O AUTOR
Corrija o erro ERROR_INVALID_TASK_DATA verificando a descrição da resposta, o tipo de tarefa, os nomes dos campos, os tipos de valores e a serialização na sua solicitação ao solucionador de CAPTCHA.

Corrija o erro ERROR_TASK_NOT_SUPPORTED verificando o tipo real de tarefa de CAPTCHA, o contrato da API e o mapeamento do SDK. Corrija solicitações incompatíveis antes de tentar novamente.
