Geetest v4 キャプチャソルバー
GeetestImageタスクタイプを使い、GeeTest v4のチャレンジを解決します。gtv: 4を設定し、v4のcaptchaIdを指定してください。questionフィールドによって、チャレンジのモードが決まります。
対応モード
| モード | question | 入力 | レスポンス |
|---|---|---|---|
| スライド | slide | 背景 + スライダー(2枚の画像) | [x, y]の座標 |
| アイコン | icon | メイン画像 + 例示画像 | クリックの座標 |
| SVGアイコン | geetest_svgicon:<prompt> | メインのSVG + 例示画像 | オブジェクトのインデックスと幾何情報 |
| 九宮格 | nine | 9枚のグリッド画像 | 一致するセルのインデックス |
| Winlinze | winlinze | 25枚のグリッド画像 | セルのインデックス |
タスクを作成 — スライド
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の移動量、グリッドの寸法を示します。タイミングのフィールドは、アイコンが表示されていたアニメーションのフレームを示します。
タスクのパラメーター
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
type | string | ✅ | GeetestImageまたはGeetestClassification |
gtv | integer | いいえ | GeeTestのバージョン。v4の場合は4 |
question | string | ✅ | slide、icon、nine、match、winlinze、geetest_svgicon:<prompt>のいずれか |
queries | string[] | ✅ | base64エンコードされた画像 |
examples | string[] | アイコン / SVGアイコン | 対象の参照画像 |
captchaId | string | ✅ | GeeTest v4のcaptcha_id |
websiteURL | string | ✅ | GeeTestのチャレンジを含むページ |
proxy | string | いいえ | 必要な場合のプロキシURL |