hCaptcha ソルバー
base64エンコードした画像と質問文を指定して、hCaptchaの画像チャレンジを解決します。APIはPopularCaptchaImageタスクタイプを使い、3つのチャレンジモードに対応しています。
対応モード
| モード | questionType | 説明 | レスポンス |
|---|---|---|---|
| グリッド / 分類 | objectClassify | グリッドから一致する画像をすべて選択 | boolean[] — 画像ごとに1つ |
| クリック | objectClick | 対象の物体の中心をクリック | {x, y}[]の座標 |
| ドラッグ&ドロップ | objectDrag | パズルのピースを正しい位置にドラッグ | {start, end}[]の座標 |
タスクを作成 — グリッド / 分類
最もよく使われるモードです。base64エンコードした画像のタイルと質問文を送信します。
POST
/createTaskホストapi.captchasonic.com
Content-Typeapplication/json
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClassify",
"question": "Select all images with a bus",
"queries": ["BASE64_IMG_1", "BASE64_IMG_2", "..."]
}
}
レスポンス
{
"code": 200,
"msg": "",
"answers": [true, false, true, true, false, true, true, true, true],
"questionType": "objectClassify",
"meta": { "pass_report": true, "fail_report": true }
}
answers[i]はqueries[i]に対応します。trueは、その画像が質問に一致することを意味します。
タスクを作成 — クリック
画像を1枚送信します。ソルバーは対象の物体の座標を返します。
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectClick",
"question": "Click on the center of the cat",
"queries": ["BASE64_MAIN_IMAGE"]
}
}
レスポンス
{
"code": 200,
"answers": [[{ "x": 142, "y": 205 }]],
"questionType": "objectClick"
}
タスクを作成 — ドラッグ&ドロップ
背景画像をqueriesに、パズルのピースをexamplesに送信します。
{
"apiKey": "YOUR_API_KEY",
"task": {
"type": "PopularCaptchaImage",
"questionType": "objectDrag",
"question": "Drag the puzzle piece to the gap",
"queries": ["BASE64_BACKGROUND"],
"examples": ["BASE64_PUZZLE_PIECE"]
}
}
レスポンス
{
"code": 200,
"answers": [[{ "start": [100, 200], "end": [150, 250] }]],
"questionType": "objectDrag"
}
タスクのパラメーター
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
type | string | ✅ | PopularCaptchaImageまたはPopularClassification |
questionType | string | ✅ | objectClassify、objectClick、objectDragのいずれか |
question | string | ✅ | チャレンジの指示文 |
queries | string[] | ✅ | base64エンコードされた画像(グリッドのタイル、またはメイン画像) |
examples | string[] | ドラッグのみ | ドラッグタスクの対象の物体 |
screenshort | boolean | いいえ | 画像がスクリーンショットの場合はtrueを設定 |