Skip to content
CaptchaSonic

Geetest v4 キャプチャソルバー

GeetestImageタスクタイプを使い、GeeTest v4のチャレンジを解決します。gtv: 4を設定し、v4のcaptchaIdを指定してください。questionフィールドによって、チャレンジのモードが決まります。

対応モード

モードquestion入力レスポンス
スライドslide背景 + スライダー(2枚の画像)[x, y]の座標
アイコンiconメイン画像 + 例示画像クリックの座標
SVGアイコンgeetest_svgicon:<prompt>メインのSVG + 例示画像オブジェクトのインデックスと幾何情報
九宮格nine9枚のグリッド画像一致するセルのインデックス
Winlinzewinlinze25枚のグリッド画像セルのインデックス

タスクを作成 — スライド

POST/createTask
ホストapi.captchasonic.com
Content-Typeapplication/json
{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 4,
        "question": "slide",
        "queries": ["BASE64_BACKGROUND", "BASE64_SLIDER"],
        "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
    }
}

レスポンス

{
    "code": 200,
    "msg": "",
    "answers": [142, 160]
}

タスクを作成 — アイコンのクリック

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 4,
        "question": "icon",
        "queries": ["BASE64_MAIN_IMAGE"],
        "examples": ["BASE64_TARGET_1", "BASE64_TARGET_2"],
        "captchaId": "e392e1d7fd421dc63325744d5a2b9c73"
    }
}

タスクを作成 — SVGアイコン

GeeTestがチャレンジをSVGで描画している場合は、geetest_svgiconを使います。メインのSVGと例示画像を送信し、質問文に対象の数を含めてください。

POST/createTask
ホストapi.captchasonic.com
Content-Typeapplication/json
{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "captchaId": "54088bb07d2df3c46b79f80300b0abbe",
        "queries": ["main-image-svg-base64"],
        "examples": ["example-png-base64"],
        "question": "geetest_svgicon:Select 1 images with",
        "websiteURL": "https://gt4.geetest.com/demov4/icon-popup-en.html"
    }
}

SVGアイコンのレスポンス

{
    "code": 200,
    "msg": "",
    "answers": {
        "objects": [0],
        "cell": 0,
        "col": 0,
        "row": 0,
        "cols": 2,
        "rows": 2,
        "x": 0.242,
        "y": 0.24,
        "viewbox_x": 72.5,
        "viewbox_y": 62.5,
        "frame": 2,
        "loop_ms": 5864,
        "visible_from_ms": 2446,
        "visible_to_ms": 4193,
        "score": 0.592
    }
}

objectsには、一致するオブジェクトのインデックスが入ります。幾何情報のフィールドは、正規化された位置、SVGのviewBoxの移動量、グリッドの寸法を示します。タイミングのフィールドは、アイコンが表示されていたアニメーションのフレームを示します。

タスクのパラメーター

プロパティ型必須説明
typestring✅GeetestImageまたはGeetestClassification
gtvintegerいいえGeeTestのバージョン。v4の場合は4
questionstring✅slide、icon、nine、match、winlinze、geetest_svgicon:<prompt>のいずれか
queriesstring[]✅base64エンコードされた画像
examplesstring[]アイコン / SVGアイコン対象の参照画像
captchaIdstring✅GeeTest v4のcaptcha_id
websiteURLstring✅GeeTestのチャレンジを含むページ
proxystringいいえ必要な場合のプロキシURL

APIプレイグラウンド

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

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

⌘ + Enter

パラメータ

apiKeystringYOUR_API_KEY
taskobject{...}
└ typestringGeetestImage
└ gtvnumber4
└ questionstringslide
└ queriesarray[2 items]
└ captchaIdstringe392e1d7fd421dc63325744d5a2b9c…

エラーコード

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