HCaptcha图像识别

通过 createTask 创建识别任务

此接口不需要进行单独获取结果, 会同步返回图像识别结果!

任务类型type如下

HCaptchaClassification

创建任务

通过 createTask 创建识别任务

参数结构

Properties	Type	Required	说明
type	String	Yes	`HCaptchaClassification`
websiteURL	String	Optional	Page source url to improve accuracy
queries	List[string]	Yes	Base64 编码的图片，不要包含 "data:image/***;base64," 以列表形式拼合图片：[base64,base64,base64,……]
question	String	Yes	只支持英文，其他语言请自行转换

queries 参数图片数量说明

select 分类问题,一次最终只支持18张图片同时识别.

draw a box 问题，每次只能识别一张图片.

支持的类型如下

类型	问题
	Please click each image containing a chair
	duck$penguin$shark$elephant
	please click on the panda

请求示例

txt

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

json

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "HCaptchaClassification",
    "question": "Please click each image containing a chair",
    //    "question": "duck$penguin$shark$elephant",
    //    "question": "please click on the panda",
    "queries": [
      "/9j/4AAQS.....",
      "/9j/4AAQ1.....",
      "/9j/4AAQ2.....",
      "/9j/4AAQ3.....",
      "/9j/4AAQ4.....",
    ]
  }
}

响应示例

json

{
  "errorId": 0,
  "errorCode": "",
  "status": "ready",
  "solution": {
    // Please click each 返回结果
    "objects": [
      true,
      false,
      false,
      true,
      true,
      false,
      true,
      true
    ],
    // Please draw a box 返回结果
    "box": [
      //x1
      198.2198,
      //y1
      629.8307,
      //x2
      851.69403,
      //y2
      817.2047
    ],
    "tags": [
      "duck",
      "penguin",
      "shark",
      "elephant",
    ],
    "imageSize": [
      //height,width
      1072,
      1000
    ]
  },
  "taskId": "5aa8be0c-94a5-11ec-80d7-00163f00a53c"
}

使用 SDK 请求

pythongolang

python

#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'

import capsolver
# capsolver.api_key = "..."
img_path = os.path.join(Path(__file__).resolve().parent,"chair.jpg")
with open(img_path,'rb') as f:
    solution = capsolver.solve({
        "type": "HCaptchaClassification",
        "question": "Please click each image containing a chair",
        "queries": [
            "/9j/4AAQS.....",
            "/9j/4AAQ1.....",
            "/9j/4AAQ2.....",
            "/9j/4AAQ3.....",
            "/9j/4AAQ4.....",
            ] 
    })
    print(solution)

package main

import (
	"fmt"
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)

func main() {
	// first you need to install sdk
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' or
	//capSolver := CapSolver{ApiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	solution, err := capSolver.Solve(map[string]any{
		"type":     "HCaptchaClassification",
		"question": "Please click each image containing a chair",
		"queries": []string{
			"/9j/4AAQS.....",
			"/9j/4AAQ1.....",
			"/9j/4AAQ2.....",
			"/9j/4AAQ3.....",
			"/9j/4AAQ4.....",
		},
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}

分类支持情况

查询接口时，直接提交问题整句，如果遇到新的分类，请联系客服增加。

因为HCaptcha更新太过频繁，所以文档不再列出所有分类，您只需要把网页上获取到的问题上传即可。

如果是全新的分类，我们将会在3个工作日内支持

如果是已经存的分类只是换了一种提问方式，我们会每天更新。

HCaptcha图像识别 ​

创建任务 ​

请求示例 ​

响应示例 ​

使用 SDK 请求 ​