HCaptcha图像识别

captchaRun

484字约2分钟

2024-05-21

注意

HCaptchaClassification 已在公开测试中，如有任何问题欢迎加群询问

重要

本接口为同步返回结果，无需轮询获取结果

重要

此对象不会返回 RESPONSE, 只返回图像识别结果!

请求识别

参考 🔗创建任务: /v2/tasks

参数名	是否必填	说明
captchaType	是	固定为 HCaptchaClassification
question	是	英文问题
queries	是	固定Base64 编码的问题图片数组
anchors	否	Base64 编码的辅助图片数组

注意

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

参数说明

queries 是要识别的图片, 一般是 9 或 18 张

anchors 是用来辅助识别的, 可以上传空数组

请求样例

POST https://api.captcha.run/v2/tasks

Content-Type: application/json
Authorization: Bearer 00000000-0000-0000-0000-000000000000

{
    "captchaType": "HCaptchaClassification",
    "question": "Please click each image containing a train",
    "queries": [
        "/9j/4AAQSkZJRg...",
        ...
    ],
    "anchors": [
        "/9j/4AAQSkZJRg...",
        ...
    ]
}

返回样例

重要

本接口立即返回结果，无需调用获取结果接口

验证码类型 grid: 九宫格 point：单图

一，当验证码类型是grid时，返回需要点击的图片位置，定义如下：

第一行为 1,2,3 第二行为 4,5,6 第三行为 7,8,9，

"captcha_answer": ["2","6","9"]

即第二，六，九为识别结果。

二，当验证码类型是point时，返回需要点击的坐标，x,y轴。

"captcha_answer": [[236.74508666992188,64.04216766357422]]

即第一组识别结果为236,64。

{
    "taskId": "ada7d30b-a12f-4105-85a5-0aa90bf0487a",
    "result": {
        "solved": true, // 判断是否识别成功
        "captcha_type": "grid", // 验证码类型 grid: 九宫格 point：单图
        "captcha_answer": [
            "2",
            "6",
            "9"
        ]
    }
}