Solve image captcha

Post an image body and receive text from it. Text can only contain digits, letters, special characters and a space. GIF animations are supported up to 500kb. Custom captchas like "find a cat in this series of images and enter its number" are not supported.

Step 1. Create task with createTask method.

Task object

Property	Type	Required	Default value	Purpose
type	String	Yes	ImageToTextTask	Defines the type of task.
body	String	Yes		File body encoded in base64. Make sure to send it without line breaks. Do not include 'data:image/png,' or similar tags, only clean base64!
phrase	Boolean	No	false	false - no requirements true - requires workers to enter an answer with at least one "space". If there are no spaces, they will skip the task, so use it with caution.
case	Boolean	No	true	false - no requirements true - workers see a special mark indicating that the answer must be entered with case sensitivity.
numeric	Integer	No	0	0 - no requirements 1 - only numbers are allowed 2 - any letters are allowed except numbers
math	Boolean	No	false	false - no requirements true - workers see a special mark telling them the answer must be calculated
minLength	Integer	No	0	0 - no requirements >0 - defines minimum length of the answer
maxLength	Integer	No	0	0 - no requirements >0 - defines maximum length of the answer
comment	String	No		Additional comments for workers like "enter red text". The result is not guaranteed and is totally up to the worker.
websiteURL	String	No		Optional parameter to distinguish source of image captchas in spending statistics.

Request example

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
}' createTask

createTask response example

JSON with no errors

JSON with an error

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

Step 2. Poll task result with getTaskResult method.

Request example

curl -i -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X POST -d '{
      "clientKey":"YOUR_API_KEY",
      "taskId":7654321
    }' getTaskResult

Task solution object

Property	Type	Purpose
text	String	Text from image captcha
url	String	Web address where we'll store the captcha for the next 24 hours, after which it will be removed.

Response example

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "text":"deditur",
        "url":"http://5.22.17.33/1/147220556452507.jpg"
    },
    "cost":"0.000500"
}