Configuração do limite de confiança para reconhecimento de CAPTCHA de texto
Como definir o limiar de confiança
No nosso serviço, a probabilidade de reconhecimento bem-sucedido de uma captcha depende da sua complexidade. Os valores do saldo são debitados apenas por captchas corretamente reconhecidas. Se a confiança do sistema na resposta for inferior ao limiar definido pelo usuário, nenhum valor será debitado.
O parâmetro recognizingThreshold aplica-se somente a ImageToTextTask (captchas de texto). Para outros tipos de captchas (ReCaptcha, Turnstile, etc.), esse parâmetro não é usado e não afeta o resultado.
Para garantir que o CapMonster Cloud retorne um resultado correto, você pode enviar junto com a solicitação de reconhecimento de captcha o parâmetro recognizingThreshold com um valor de 0 a 100. Esse parâmetro permite definir o nível mínimo de confiança do sistema na resposta correta da captcha, determinando o valor mínimo abaixo do qual nenhum débito será realizado no saldo.
Exemplo
POST
https://api.capmonster.cloud/createTask
{
"task": {
...
"recognizingThreshold" : 70
},
"clientKey":"API_KEY",
"softId" : 345
}
Nesse caso, se o parâmetro for igual a 70, apenas respostas em que nosso sistema tem mais de 70% de certeza serão retornadas; caso contrário, será retornado o erro: “ERROR_CAPTCHA_UNSOLVABLE”.
O limite de confiança é uma métrica interna usada pelo sistema para avaliar a probabilidade de que o texto reconhecido esteja correto. Quanto maior o limite, mais precisas são as respostas, mas também aumenta a frequência com que as tarefas podem ser consideradas insolúveis (ERROR_CAPTCHA_UNSOLVABLE).
Outra maneira de passar um limite é usar apenas o campo para especificar a ApiKey. Você pode adicionar a informação do limite no seguinte formato: {apikey}__recognizingthreshold_{value}
Por exemplo, “API_KEY__recognizingthreshold_70”.
Você também pode inserir o nome do módulo com a chave no seguinte formato: {apikey}__module-name.
A chave, o limite de confiança e o nome do módulo são indicados com o sublinhado “__”.
Exemplo: “API_KEY__solvemedia__recognizingthreshold_70”.
Se você não conseguir definir o limite de confiança da resposta, entre em contato com nossa equipe de suporte, nós ajudaremos você a configurá-lo!
