版本比较

密钥

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

请求节点:

状态
colourGreen
title国际节点
https://api.yescaptcha.com
状态
colourGreen
title国内节点
https://cn.yescaptcha.com

请求地址: https://api.yescaptcha.com/createTask

请求格式:POST application/json

对象结构

属性

类型

必须

说明

type

string

ReCaptchaV2Classification 300x300 450x450

状态
title10 POINTS
->
状态
colourGreen
title8 POINTS
100x100
状态
colourGreen
title2 点数

image

string

Base64 编码的图片,不要包含 "data:image/***;base64,"

说明

必须将图片缩放至 标准 大小 (100x100, 300x300, 450x450), 这样服务才能判断图片类型

question

String

问题 ID, 请查表, 以 /m/ 开头

confidence

int

结果置信度分值,非必填,0.0 不匹配 ~1.0 完全匹配(分值越大匹配度越高),默认值为空

对于3x3 类型的图片,当指定一个分值时(建议0.5),会返回所有大于该分值的结果,不指定时会返回排名前三的结果。

对于4x41x1的图片指定此值无意义

具体使用场景见下方说明。

请求示例

代码块
languagejson
{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
    "task": {
        "type": "ReCaptchaV2Classification",
        "image": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDc....",
        "question": "/m/0k4j"
    }
}

...

代码块
{
  "/m/0pg52": "taxis",
  "/m/01bjv": "bus",
  "/m/02yvhj": "school bus",
  "/m/04_sv": "motorcycles",
  "/m/013xlm": "tractors",
  "/m/01jk_4": "chimneys",
  "/m/014xcs": "crosswalks", // pedestrian crossings 也是一样的
  "/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"
}

错误信息

errorCode

errorDescription

说明

ERROR_INTERNAL_SERVER_ERROR

服务器内部错误

请确保各项参数正确

ERROR_UNKNOWN_QUESTION

错误的问题ID

请检查问题ID是否正确

ERROR_ILLEGAL_IMAGE

图片大小不符合要求

请缩放至指定大小450x450/300x300/100x100

ERROR_UNKNOW_450x450_QUESTION

这个尺寸暂时不支持这个问题

暂时不能很好的识别这个问题相关的图片,请重试其他类型的图片

ERROR_PARSE_IMAGE_FAIL

解析图片失败

请确认图片BASE64编码是否正确

字段confidence使用说明

reCaptcha有三种类型的需要识别,1种是3x3的九宫格,1种是4x4的十六宫格,当3x3的图片点击之后会继续刷新小图,这种就是1x1的小图。

...