reCAPTCHA v2 图像识别

ReCaptchaV2Classification 识别 reCAPTCHA v2 弹出的图片题：把图片和题目 ID 发过来，返回应该点击哪几个格子，由你的程序在浏览器里点击。它不返回 token。同步返回，一次 createTask 请求就拿到结果；3x3、4x4 图片每张 6 点（0.006 元），1x1 小图更便宜，见下表。

提示

不想自己写点击逻辑，可以直接用 浏览器插件，它基于这个接口自动点击。

POSThttps://api.yescaptcha.com/createTask国际节点复制

POSThttps://cn.yescaptcha.com/createTask国内节点复制

类型与价格

任务类型	价格	返回方式	说明
ReCaptchaV2Classification	6 点（0.006 元）	同步	1x1 小图（100x100）2 点；3x3（300x300）、4x4（450x450）6 点

请求参数

字段	类型	必填	说明
type	string	是	任务类型，取值见本页"类型与价格"
image	string	是	题目图片的 Base64 编码，不带 data: 前缀
question	string	是	题目的 ID（如 /m/0k4j），对照表见本页"题目 ID"
confidence	number	否	置信度阈值，0 到 1。只对 3x3 图片有效：传了（建议 0.5）返回所有高于这个值的格子，不传返回最可能的 3 个

图片必须缩放到标准尺寸，服务端按尺寸判断题型：

题型	图片尺寸	返回
3x3 九宫格（“选择所有图片”）	300 × 300	objects：要点击的格子
4x4 十六宫格（“选择所有图块”）	450 × 450	objects：要点击的格子
1x1 小图（3x3 点击后刷新出来的单张图）	100 × 100	hasObject：这张图要不要点

是截图的话，看题目判断：3x3 的题目是“选择所有图片”（Select all images with …），4x4 是“选择所有图块”（Select all squares with …）。

请求示例

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

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

返回结果

3x3、4x4：

{
  "errorId": 0,
  "status": "ready",
  "solution": { "objects": [1, 5, 8], "type": "multi" },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

1x1 小图：

{ "errorId": 0, "status": "ready", "solution": { "hasObject": true, "type": "single" } }

字段	类型	说明
objects	array	应该点击的图片序号（从 0 开始，按从左到右、从上到下）
hasObject	boolean	1x1 小图时返回：这张图里是否有目标
type	string	题目类型：multi（3x3、4x4 大图，看 objects）、single（1x1 小图，看 hasObject）；hCaptcha 拖动题为 drag

格子的编号从 0 开始，从左到右、从上到下：

confidence：一次返回所有符合的格子

3x3 题目点完之后通常会刷新出 1x1 小图，需要继续判断。如果不方便获取小图（例如在手机端开发），可以传 confidence：

• 不传时，3x3 图片返回得分最高的 3 个格子（reCAPTCHA 要求至少点 3 个）。
• 传了（建议 0.5）时，返回所有得分高于这个值的格子，可能多于或少于 3 个；没有符合的返回空数组。这样不用再截 1x1 小图。
• 对 4x4 和 1x1 图片没有作用。

题目 ID

question 填题目的 ID（以 /m/ 开头），不是题目文字。ID 在 reCAPTCHA 加载题目的请求（reload 或 userverify）的响应里，和图片一起下发。下表是常见题目，中文仅供参考：

共 16 种

题目 ID	题目（英文）	中文说明
/m/0pg52	taxis	出租车
/m/01bjv	bus	公交车（含校车）
/m/04_sv	motorcycles	摩托车
/m/013xlm	tractors	拖拉机
/m/01jk_4	chimneys	烟囱
/m/014xcs	crosswalks	人行横道
/m/015qff	traffic lights	红绿灯
/m/0199g	bicycles	自行车
/m/015qbp	parking meters	停车计价器
/m/0k4j	cars	汽车
/m/015kr	bridges	桥
/m/019jd	boats	船
/m/0cdl1	palm trees	棕榈树
/m/09d_r	mountains or hills	山
/m/01pns0	fire hydrant	消防栓
/m/01lynh	stairs	楼梯

返回 ERROR_UNKNOWN_QUESTION 说明 ID 填错了或者这道题暂不支持；ERROR_UNKNOW_450x450_QUESTION 说明这道题暂不支持 4x4 图片，在网页上刷新换一题即可。

上报和返点

点击后验证失败的，可以在 1 小时内用 report 上报，约 24 小时后结算返点，规则见 计费与退点。

相关教程

• reCAPTCHA v2 图像识别模拟点击（Selenium）
• reCAPTCHA v2（返回 token）