UNLOCK API

API per risolvere Griglia di immagini

Invia un task Griglia di immagini all'API e ricevi la risposta che il tuo codice invia alla pagina. L'immagine della griglia in base64 e l'istruzione, ad esempio l'oggetto da selezionare. Ricevi: I numeri delle celle da cliccare.

In breve

Prezzo ogni 1,000
$0.36 ($0.00036 per task)
Tipo createTask
GridTask
Metodo in.php
post, recaptcha=1
Invii
L'immagine della griglia in base64 e l'istruzione, ad esempio l'oggetto da selezionare
Ricevi
I numeri delle celle da cliccare

Dove trovare i valori

Invia l'intera griglia come un'unica immagine e l'istruzione come comment. rows e columns valgono 3 di default.

createTask e getTaskResult

Crea il task, attendi circa 5 secondi, poi controlla il risultato ogni 5 secondi finché lo stato è ready. Se il task fallisce, l'API restituisce un errore e l'importo torna sul saldo.

import time, requests

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

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "GridTask",
      "body": "/9j/4AAQSkZJRgABAQ...",
      "comment": "Select all squares with traffic lights",
      "rows": 3,
      "columns": 3
    }
}).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 e res.php

Lo stesso task con la classica API a form. Aggiungi json=1 per ricevere risposte JSON; senza, le risposte sono in testo semplice, ad esempio OK|1001.

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=base64&recaptcha=1&textinstructions=Select+all+traffic+lights&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"}

Riferimento API completo: tutti i parametri e l'oggetto solution