Skip to content
CaptchaSonic

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"
}

タスクのパラメーター

プロパティ型必須説明
typestring✅PopularCaptchaImageまたはPopularClassification
questionTypestring✅objectClassify、objectClick、objectDragのいずれか
questionstring✅チャレンジの指示文
queriesstring[]✅base64エンコードされた画像(グリッドのタイル、またはメイン画像)
examplesstring[]ドラッグのみドラッグタスクの対象の物体
screenshortbooleanいいえ画像がスクリーンショットの場合はtrueを設定

APIプレイグラウンド

POST
ログイン してAPIキーを自動入力
ペイロード
レスポンス

送信を押すと、レスポンスが表示されます

⌘ + Enter

パラメータ

apiKeystringYOUR_API_KEY
taskobject{...}
└ typestringPopularCaptchaImage
└ questionTypestringobjectClassify
└ questionstringSelect all images with a bus
└ queriesarray[2 items]

エラーコード

1KEY_DOES_NOT_EXIST
2NO_SLOT_AVAILABLE
3ZERO_BALANCE
10ERROR_BAD_PARAMETERS
12ERROR_CAPTCHA_UNSOLVABLE
14PLAN_EXPIRED
16RATE_LIMITED
17DAILY_LIMIT_EXCEEDED
18QUOTA_LIMIT_EXCEEDED
21SERVICE_UNAVAILABLE
コード
terminal