Skip to content
capzy
Get Started
Image to Text
ImageToTextTask

Image to Text Solver, solved in 5.0s.

OCR-based captcha solving. Send an image containing text, get back the recognized text. Works on any text-based captcha.

Get API KeyTry DemoExamples
Avg Speed~5.0s
Success99%+
Cost / 1k$2.00
Throughput12/m

A generic OCR task for solving text-based captchas. Send a base64-encoded image containing distorted text, and we return the recognized text using our ML OCR pipeline.

Quick Integration

solve.py
import requests, time

API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"

# Step 1: Create task
task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
        "type": "ImageToTextTask",
        "body": "/9j/4AAQSkZJRgABAQ..."
    }
}).json()

task_id = task["taskId"]
print(f"Task created: {task_id}")

# Step 2: Poll for result
while True:
    result = requests.post(f"{API}/getTaskResult", json={
        "clientKey": KEY,
        "taskId": task_id
    }).json()

    if result["status"] == "ready":
        print("Solved!", result["solution"])
        break
    elif result["status"] == "failed":
        print("Failed:", result.get("errorDescription"))
        break

    time.sleep(1)

Using the result

use_result.py
# Step 3: Image-to-text / math — submit the recognized text as the captcha answer
answer = result["solution"]["text"]
requests.post("https://target.example.com/login", data={"username": "...", "captcha": answer})

1. Send Payload

Dispatch your ImageToTextTask to our processing cluster via the secure API endpoint.

2. Solving Engine

Capzy's proprietary OCR transcribes the text from the image. Designed for accessibility tooling, archival document processing, and authorized automation workflows.

3. Get Result

Poll getTaskResult for the validated token, then finalize your automated request.

Task Parameters

API Spec
typetypestringreqyesImageToTextTask
bodytypestringreqyesBase64-encoded image (PNG, JPG, GIF, BMP)
casetypestringreqnoOptional. Restrict the output to a character set. Values: 'mixed' (default — preserve everything including symbols, hyphens, dots, @ signs), 'letters' (a-zA-Z only), 'numbers' (0-9 only), 'alphanumeric' (a-zA-Z0-9 only, no symbols). Wrong hints never leak an out-of-class character — the backend filters as a safety net.
moduletypestringreqnoAlternative field name for `case`. Accepts 'common' (= mixed), 'number' (= numbers), 'alpha' (= letters). Provided as a migration convenience — `case` is the canonical field and is the only one that supports the 4th `alphanumeric` mode.

Response Shape

texttypestringThe recognized text from the image

Example response

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

Error response

{
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "Solver gave up."
}

Features

Works on any text-based captcha
Capzy proprietary OCR models
Supports distorted/noisy text
< 1 second solve time

Pricing & Stats

Per 1,000 solves$2.00
Avg solve time~5.0s
Success rate99%+
Throughput12/m

Start solving image to text.

$0.10 in free credits — no card. ~250 free solves to test before you spend.

Get free API key Read docs

Frequently asked questions