UNLOCK API
图片网格

图片网格

如何通过 createTask 或 in.php 向 UNLOCK API 发送 图片网格 任务:任务类型名称、全部参数、solution 对象、代理字段,以及 7 种语言的代码示例。
价格
$0.36 每个任务 $0.00036
你发送
base64 格式的网格图片和说明,例如要选择的对象
你得到
要点击的格子编号

简介和价格

任务类型名称

此类型只有一个名称。
GridTask

也接受: GridTaskProxyless

task 对象

type
String必填
任务类型名称。不区分大小写。 GridTask
body
String必填
base64 格式的图片(JPG、PNG 或 GIF),最大约 100 KB。可以带 data: 前缀。
comment
String可选
给识别方的说明,例如图片上方显示的问题。
rows
Integer可选
网格的行数。
columns
Integer可选
网格的列数。
imgType
String可选
图片类型(如果知道)。
previousId
String可选
第一次回答后网格发生变化时,前一个任务的 id。
canSkip
Boolean可选
答案可能是没有匹配的格子时为 true。

此处未列出的字段会原样传给识别方。

请求

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "GridTask",
    "body": "/9j/4AAQSkZJRgABAQ...",
    "comment": "Select all squares with traffic lights",
    "rows": 3,
    "columns": 3
  }
}

solution 对象

status 为 ready 时在 solution 中返回。
click
Array
要点击的格子编号,从 1 开始,从左到右、从上到下计数。
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "click": [
      1,
      4,
      9
    ]
  },
  "cost": "0.00036",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

代码示例

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 表单方法

用传统表单请求发送同一任务。res.php 以文本形式返回答案。
in.php, res.php
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"}

表单 API:in.php 和 res.php