UNLOCK API

Umranden Lösungs-API

Senden Sie eine Umranden-Aufgabe an die API und erhalten Sie die Antwort, die Ihr Code an die Seite übermittelt. Das Bild als base64 und was umrandet werden soll. Sie erhalten: Punkte der gezeichneten Umrandung.

Auf einen Blick

Preis pro 1.000
$0.60 ($0.0006 pro Aufgabe)
createTask-Typ
DrawAroundTask
in.php-Methode
post, canvas=1
Sie senden
Das Bild als base64 und was umrandet werden soll
Sie erhalten
Punkte der gezeichneten Umrandung

Wo Sie die Werte finden

Senden Sie das Bild und die Anweisung als comment.

createTask und getTaskResult

Erstellen Sie die Aufgabe, warten Sie etwa 5 Sekunden und prüfen Sie dann alle 5 Sekunden das Ergebnis, bis der Status ready ist. Schlägt die Aufgabe fehl, liefert die API einen Fehler und der Betrag geht auf Ihr Guthaben zurück.

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "DrawAroundTask",
      "body": "/9j/4AAQSkZJRgABAQ...",
      "comment": "Draw around the dog"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"])
        break
else:
    raise SystemExit("timed out")

in.php und res.php

Dieselbe Aufgabe mit der klassischen Formular-API. Mit json=1 erhalten Sie JSON-Antworten, ohne diesen Parameter Text wie OK|1001.

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=base64&canvas=1&textinstructions=Draw+around+the+dog&body=BASE64_IMAGE&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

Vollständige API-Referenz: alle Parameter und das solution-Objekt