ImageToText

Ver preço completo

Este é um captcha regular, que é uma imagem com texto a ser inserido na linha correspondente.

Atenção!

O uso de servidores proxy para esta tarefa não é necessário.

Parâmetros da solicitação

type<string>required

ImageToTextTask

body<string>required

Corpo do arquivo codificado em base64*. Certifique-se de enviá-lo sem quebras de linha.

capMonsterModule<string>optional

Nome do módulo de reconhecimento, por exemplo, “yandex“. Forma alternativa de passar o nome do módulo e a lista de todos os módulos disponíveis que você pode encontrar aqui.
Exemplo: yandex, special e outros.

recognizingThreshold<integer>optional

Limite de reconhecimento de captcha com valor possível de 0 a 100. Por exemplo, se o recognizingThreshold foi definido como 90 e a tarefa foi resolvida com uma confiança de 80, você não será cobrado. Nesse caso, o usuário receberá uma resposta ERROR_CAPTCHA_UNSOLVABLE. Um método alternativo para definir o limite de dedução de dinheiro é descrito no artigo.

case<boolean>optional

true - se o captcha for sensível a maiúsculas e minúsculas.

numeric<integer>optional

1 - se o captcha contiver apenas números.
Valores possíveis: 0, 1

math<boolean>optional

false — indefinido;
true — se o captcha exigir uma operação matemática (por exemplo: captcha 2 + 6 = retornará o valor 8). Importante: Não use o parâmetro math: true para o módulo captcha_math.

*Base64 é um método de codificação de dados que permite representar dados binários como texto. Aqui está um exemplo de obtenção de uma imagem captcha em formato base64 usando o console nas Ferramentas de Desenvolvedor:

const captchaUrl = 'https://example.com/captcha.jpg';

function loadAndEncodeCaptchaToBase64(url) {
    fetch(url)
        .then(response => response.blob())
        .then(blob => {
            const reader = new FileReader();
            reader.readAsDataURL(blob);

            reader.onloadend = function() {
                const base64Data = reader.result;                
                console.log('Base64 Encoded Captcha:', base64Data);
                          
						  };
        })
        .catch(error => {
            console.error('Error occurred while loading or encoding the captcha:', error);
        });
}

loadAndEncodeCaptchaToBase64(captchaUrl);

Criar tarefa

POST

https://api.capmonster.cloud/createTask

Solicitação

{
  "clientKey":"API_KEY",
  "task": {
    "type":"ImageToTextTask",
    "body":"BASE64_BODY_HERE!"
  }
}

Resposta

{
  "errorId":0,
  "taskId":407533072
}

Obter resultado da tarefa

Use o método getTaskResult para obter a solução do captcha. Dependendo da carga do sistema, você receberá uma resposta em um intervalo de 300ms a 6s.

POST

https://api.capmonster.cloud/getTaskResult

Solicitação

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Resposta

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "text":"answer"
  }
}

Propriedade	Tipo	Descrição
text	String	Resposta do captcha

Como Encontrar Todos os Parâmetros Necessários para a Criação da Tarefa

Manualmente

Abra seu site onde o captcha aparece no navegador.
Clique com o botão direito no elemento do captcha e selecione Inspecionar.

base64

Localize o elemento necessário na árvore DOM e passe o mouse sobre ele – a imagem codificada em base64 será exibida diretamente nos atributos do elemento:

base64elements

Se a imagem fizer referência a uma URL externa em vez de conter dados codificados em base64, você pode encontrá-la nas requisições de rede (Network). Clique com o botão direito na requisição relevante e selecione Copiar imagem como URI de dados. Isso copiará os dados da imagem codificados em base64 para sua área de transferência.

base64network

Automaticamente

Para automatizar a extração dos parâmetros, eles podem ser obtidos via navegador (normal ou headless, por exemplo, usando Playwright) ou diretamente a partir de requisições HTTP. Como os valores dos parâmetros dinâmicos têm curta duração, recomenda-se utilizá-los imediatamente após a extração.

Importante!

Os trechos de código fornecidos são exemplos básicos para aprendizado sobre como extrair os parâmetros necessários. A implementação exata dependerá do seu site com captcha, sua estrutura e os elementos HTML e seletores utilizados.

JavaScript
Python
C#

Mostrar código (para navegador)

(async () => {
  const img = document.querySelector('img'); // Seletor de exemplo

  const imageUrl = img.src;

  const response = await fetch(imageUrl);

  if (!response.ok) {
    throw new Error("Falha ao carregar a imagem");
  }

  const buffer = await response.arrayBuffer();

  // Converter dados binários para base64
  const base64Image = btoa(String.fromCharCode(...new Uint8Array(buffer)));

  console.log(base64Image); 
})();

Mostrar código (Node.js)

(async () => {
  const imageUrl = "https://example/img/.jpg"; // URL da imagem

  const response = await fetch(imageUrl);

  if (!response.ok) {
    throw new Error("Falha ao carregar a imagem");
  }

  const buffer = await response.arrayBuffer();

  // Converter dados para base64
  const base64Image = Buffer.from(buffer).toString("base64");

  console.log(base64Image);
})();

Mostrar código

import requests
import base64

# URL da imagem
image_url = "https://example/img.jpg"

response = requests.get(image_url)

if response.status_code == 200:
    # Converter dados binários da imagem para base64
    base64_image = base64.b64encode(response.content).decode('utf-8')

    print(base64_image)
else:
    print("Falha ao carregar a imagem")

Mostrar código

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // URL da imagem
        string imageUrl = "https://example/img.jpg";

        using (HttpClient client = new HttpClient())
        {
            try
            {
                byte[] imageBytes = await client.GetByteArrayAsync(imageUrl);

                // Converter dados binários da imagem para base64
                string base64Image = Convert.ToBase64String(imageBytes);

                Console.WriteLine(base64Image);
            }
            catch (Exception ex)
            {
                Console.WriteLine("Falha ao carregar a imagem: " + ex.Message);
            }
        }
    }
}

Usar biblioteca SDK

JavaScript
Python
C#

Mostrar Código (para navegador)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ImageToTextRequest, CapMonsterModules } from '@zennolab_com/capmonstercloud-client';

document.addEventListener('DOMContentLoaded', async () => {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: 'YOUR_API_KEY' }) // Insira sua chave de API do CapMonster Cloud
    );

    // Se necessário, você pode verificar o saldo
    const balance = await cmcClient.getBalance();
    console.log("Balance:", balance);

    const imageToTextRequest = new ImageToTextRequest({
        body: 'some base64 body', // Substitua pelo valor real
        CapMonsterModule: CapMonsterModules.YandexWave,
        Case: true,
        numeric: 1,
        recognizingThreshold: 65,
        math: false
    });

    const result = await cmcClient.Solve(imageToTextRequest);
    console.log("Solution:", result);
});

Mostrar Código (Node.js)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ImageToTextRequest, CapMonsterModules } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // Insira sua chave de API do CapMonster Cloud

async function solveImageToText() {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // Se necessário, você pode verificar o saldo
    const balance = await cmcClient.getBalance();
    console.log("Balance:", balance);

    const imageToTextRequest = new ImageToTextRequest({
        body: 'some base64 body', // Substitua pelo valor real
        CapMonsterModule: CapMonsterModules.YandexWave,
        Case: true,
        numeric: 1,
        recognizingThreshold: 65,
        math: false
    });

    const result = await cmcClient.Solve(imageToTextRequest);
    console.log("Solution:", result);
}

solveImageToText().catch(console.error);

Mostrar Código

# https://github.com/ZennoLab/capmonstercloud-client-python

import asyncio
import base64
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import ImageToTextRequest

# Insira sua chave de API do CapMonster Cloud
client_options = ClientOptions(api_key="YOUR_API_KEY")
cap_monster_client = CapMonsterClient(options=client_options)

# Imagem em formato base64
image_base64 = "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgc...wwzqR4U/yZ//Z"  # Substitua pelo valor real
image_bytes = base64.b64decode(image_base64)

image_to_text_request = ImageToTextRequest(
    image_bytes=image_bytes,
    module_name=None,     # Você pode escolher um módulo, por exemplo YandexWave
    threshold=50,     
    case=True,     
    numeric=0,    
    math=False         
)

async def solve_captcha():
    # Se necessário, você pode verificar o saldo
    balance = await cap_monster_client.get_balance()
    print("Balance:", balance)

    solution = await cap_monster_client.solve_captcha(image_to_text_request)
    return solution

responses = asyncio.run(solve_captcha())
print("Solution:", responses)

Mostrar Código

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

using System;
using System.Threading.Tasks;
using Zennolab.CapMonsterCloud.Requests;
using Zennolab.CapMonsterCloud;

class Program
{
    static async Task Main(string[] args)
    {
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY" // Insira sua chave de API do CapMonster Cloud
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        // Se necessário, você pode verificar o saldo
        var balance = await cmCloudClient.GetBalanceAsync();
        Console.WriteLine("Balance: " + balance);

        var imageToTextRequest = new ImageToTextRequest
        {
            Body = "/9j/4AAQSkZJRgABAQAAAQABA...wwzqR4U/yZ//Z", // Substitua pelo valor real
            CapMonsterModule = "None",  
            RecognizingThreshold = 70, 
            CaseSensitive = true,
            Numeric = false, 
            Math = false
        };

        var imageToTextResult = await cmCloudClient.SolveAsync(imageToTextRequest);

        Console.WriteLine("Captcha Solved: " + imageToTextResult.Solution.Value);
    }
}

Parâmetros da solicitação​

Criar tarefa​

Obter resultado da tarefa​

Como Encontrar Todos os Parâmetros Necessários para a Criação da Tarefa​

Manualmente​

base64​

Automaticamente​

Usar biblioteca SDK​