Strona główna Dokumentacja Tutoriale Logowanie
Obsługiwane typy zadań
Metody API
Artykuły
Tutoriale
GitHub
Menu dokumentacja

ImageToTextTask : rozwiązywanie captcha obrazkowego

Prześlij treść obrazka i otrzymaj tekst. Tekst może składać się wyłącznie z cyfr, liter, znaków specjalnych i spacji. Animacje GIF są obsługiwane, aż do 500kb. Specjalne zadania jak "znajdź kota w zestawie obrazków i przepisz numer obrazka" nie są obsługiwane.

Obiekt zadanie

Właściwość/atrybut Typ Wymagany Domyślna wartość Przeznaczenie
type Łańcuch znaków (String) Tak ImageToTextTask Definiuje rodzaj zadania.
body Łańcuch znaków (String) Tak Plik zakodowany w base64. Upewnij się, że wysyłasz bez znaków końca linii. Nie należy dołączać 'data:image/png,' ani innych tagów, wyłącznie czyste base64!
phrase Logiczny (Boolean) Nie false false - brak wymagań
true - pracownik musi wpisać odpowiedź z przynajmniej jedną "spacją". Jeśli spacji nie ma, pominą zadanie, należy więc zachować ostrożność.
case Logiczny (Boolean) Nie true false - brak wymagań
true - pracownik dostanie informację, aby rozwiązywać zagadkę z uwzględnieniem wielkich i małych liter.
numeric Integer Nie 0 0 - brak wymagań
1 - dozwolone tylko cyfry
2 - dozwolone tylko litery, bez cyfr
math Logiczny (Boolean) Nie false false - brak wymagań
true - pracownik dostanie informację, że odpowiedź trzeba wyliczyć
minLength Integer Nie 0 0 - brak wymagań
>1 - definiuje minimalną długość odpowiedzi
maxLength Integer Nie 0 0 - brak wymagań
>1 - definiuje maksymalną długość odpowiedzi
comment Łańcuch znaków (String) Nie Dodatkowy komentarz dla pracowników, na przykład "wpisuj tylko litery oznaczone na czerwono".
Wynik nie jest jednak gwarantowany i wszystko zależy od pracownika.
websiteURL Łańcuch znaków (String) Nie Opcjonalny parametr pozwalający rozróżnić źródła captcha obrazkowych w statystykach obciążeń konta.

Przykład żądania

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY_HERE",
    "task":
        {
            "type":"ImageToTextTask",
            "body":"BASE64_BODY_HERE__NO_NEWLINES__NO_EXTRA_TAGS__ONLY_CLEAN_BASE64",
            "phrase":false,
            "case":false,
            "numeric":0,
            "math":false,
            "minLength":0,
            "maxLength":0
        },
    "softId": 0
}' https://api.anti-captcha.com/createTask
        
PHP
          <?php

//git clone git@github.com:AdminAnticaptcha/anticaptcha-php.git

include("anticaptcha.php");
include("imagetotext.php");

$api = new ImageToText();

//your anti-captcha.com account key
$api->setKey("YOUR_API_KEY_HERE");

//setting file
$api->setFile("captcha.jpg");

//Specify softId to earn 10% commission with your app.
//Get your softId here: https://anti-captcha.com/clients/tools/devcenter
$api->setSoftId(0);

//create task in API
if (!$api->createTask()) {
    echo "API v2 send failed - ".$api->getErrorMessage()."\n";
    exit;
}

$taskId = $api->getTaskId();

if (!$api->waitForResult()) {
    echo "could not solve captcha\n";
    echo $api->getErrorMessage()."\n";
} else {
    $captchaText    =   $api->getTaskSolution();
    echo "captcha text: $captchaText\n\n";
}
        
Python
          #pip3 install anticaptchaofficial

from anticaptchaofficial.imagecaptcha import *

solver = imagecaptcha()
solver.set_verbose(1)
solver.set_key("YOUR_API_KEY_HERE")

# Specify softId to earn 10% commission with your app.
# Get your softId here: https://anti-captcha.com/clients/tools/devcenter
solver.set_soft_id(0)

captcha_text = solver.solve_and_return_solution("captcha.jpeg")
if captcha_text != 0:
    print "captcha text "+captcha_text
else:
    print "task finished with error "+solver.error_code
        
NodeJS
          //npm install @antiadmin/anticaptchaofficial
//https://github.com/AdminAnticaptcha/anticaptcha-npm

const ac = require("@antiadmin/anticaptchaofficial");
const fs = require('fs');

const captcha = fs.readFileSync('captcha.png', { encoding: 'base64' });

ac.setAPIKey('YOUR_API_KEY_HERE');

//Specify softId to earn 10% commission with your app.
//Get your softId here: https://anti-captcha.com/clients/tools/devcenter
ac.setSoftId(0);

ac.solveImage(captcha, true)
    .then(text => console.log('captcha text: '+text))
    .catch(error => console.log('test received error '+error));
        
C#
          //git clone git@github.com:AdminAnticaptcha/anticaptcha-csharp

using System;
using Anticaptcha_example.Api;
using Anticaptcha_example.Helper;
using Newtonsoft.Json.Linq;

namespace Anticaptcha_example
{
    internal class Program
    {
        private static void Main() {

            DebugHelper.VerboseMode = true;

            var api = new ImageToText
            {
                ClientKey = "YOUR_API_KEY_HERE",
                FilePath = "captcha.jpg",
                // Specify softId to earn 10% commission with your app.
                // Get your softId here:
                // https://anti-captcha.com/clients/tools/devcenter
                SoftId = 0
            };

            if (!api.CreateTask())
                DebugHelper.Out("API v2 send failed. " + api.ErrorMessage, DebugHelper.Type.Error);
            else if (!api.WaitForResult())
                DebugHelper.Out("Could not solve the captcha.", DebugHelper.Type.Error);
            else
                DebugHelper.Out("Result: " + api.GetTaskSolution().Text, DebugHelper.Type.Success);

        }
    }
}

        
Java
          //git clone git@github.com:AdminAnticaptcha/anticaptcha-java.git

package com.anti_captcha;

import com.anti_captcha.Api.ImageToText;
import com.anti_captcha.Helper.DebugHelper;

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

import java.net.MalformedURLException;
import java.net.URL;
import java.util.Iterator;
import java.util.concurrent.ThreadLocalRandom;

public class Main {

    public static void main(String[] args) throws InterruptedException, MalformedURLException, JSONException {
        DebugHelper.setVerboseMode(true);

        ImageToText api = new ImageToText();
        api.setClientKey("YOUR_API_KEY_HERE");
        api.setFilePath("captcha.jpg");

        //Specify softId to earn 10% commission with your app.
        //Get your softId here: https://anti-captcha.com/clients/tools/devcenter
        api.setSoftId(0);

        if (!api.createTask()) {
            DebugHelper.out(
                    "API v2 send failed. " + api.getErrorMessage(),
                    DebugHelper.Type.ERROR
            );
        } else if (!api.waitForResult()) {
            DebugHelper.out("Could not solve the captcha.", DebugHelper.Type.ERROR);
        } else {
            DebugHelper.out("Result: " + api.getTaskSolution().getText(), DebugHelper.Type.SUCCESS);
        }
    }

}
        

Przykład odpowiedzi

JSON bez błędów
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON z błędem
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

Odbierz rozwiązanie

Skorzystaj z metody getTaskResult by odebrać rozwiązanie. Daj pracownikowi trochę czasu, na przykład 5 sekund, zanim prześlesz pierwszą prośbę odbioru. Jeśli pracownik nadal jest zajęty, powtórz próbę po 3 sekundach.

Obiekt rozwiązanie zadania

Właściwość/atrybut Typ Przeznaczenie
text Łańcuch znaków (String) Tekst z captcha obrazkowego
url Łańcuch znaków (String) Adres w sieci, gdzie będziemy przechowywać captcha przez kolejne 24 godziny. Po tym okresie jest ona usuwana.

Przykład odpowiedzi

JSON bez błędów
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "text":"deditur",
        "url":"http://61.39.233.233/1/147220556452507.jpg"
    },
    "cost":"0.000700",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}