ImageToText

Create a task

POST https://api.nocaptchaai.com/createTask

{ "clientKey": "YOUR_API_KEY", "task": { "type": "ImageToTextTask", "body": "/9j/4AAQSkZJRgABAQ....", "case": false, "numeric": 0, "math": false, "minLength": 0, "maxLength": 0 } }

Returns a taskId:

{ "errorId": 0, "status": "idle", "taskId": "abc123" }

Get the result

Poll POST https://api.nocaptchaai.com/getTaskResult until status is ready:

{ "clientKey": "YOUR_API_KEY", "taskId": "abc123" }

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

Code example

import requests, time
API_KEY = "YOUR_API_KEY"; BASE = "https://api.nocaptchaai.com"
task = requests.post(f"{BASE}/createTask", json={"clientKey": API_KEY, "task": { "type": "ImageToTextTask", "body": "/9j/4AAQSkZJRgABAQ....", "case": False, "numeric": 0, "math": False, "minLength": 0, "maxLength": 0 }}).json()
tid = task["taskId"]
while True:
    time.sleep(2)
    res = requests.post(f"{BASE}/getTaskResult", json={"clientKey": API_KEY, "taskId": tid}).json()
    if res.get("status") == "ready":
        print(res["solution"]); break
    if res.get("status") == "failed" or res.get("errorId"):
        raise SystemExit(res)

const API_KEY = "YOUR_API_KEY", BASE = "https://api.nocaptchaai.com";
const create = await fetch(`${BASE}/createTask`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ clientKey: API_KEY, task: { type: "ImageToTextTask", body: "/9j/4AAQSkZJRgABAQ....", case: false, numeric: 0, math: false, minLength: 0, maxLength: 0 } }) }).then(r => r.json());
let out;
while (true) {
  await new Promise(r => setTimeout(r, 2000));
  const res = await fetch(`${BASE}/getTaskResult`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ clientKey: API_KEY, taskId: create.taskId }) }).then(r => r.json());
  if (res.status === "ready") { out = res.solution; break; }
  if (res.status === "failed" || res.errorId) throw new Error(JSON.stringify(res));
}
console.log(out);

curl -X POST https://api.nocaptchaai.com/createTask -H "Content-Type: application/json" -d '{ "clientKey": "YOUR_API_KEY", "task": { "type": "ImageToTextTask", "body": "/9j/4AAQSkZJRgABAQ....", "case": false, "numeric": 0, "math": false, "minLength": 0, "maxLength": 0 } }'

Next steps

API Playground

Try createTask live against production.

Quickstart

Get your API key and make a first call.

More image tasks

reCAPTCHA, GeeTest, OCR, BLS, AWS WAF and more.