ガイド
タスク(認識)
hCaptcha

HCaptcha画像認識

WARNING

タスクはcreateTaskを使用して作成します。

このインターフェースでは、結果を別途取得する必要はありません。画像認識の結果を同期的に返します!

タスクの種類 type は次の通りです

  • HCaptchaClassification

タスクの作成

createTaskを使用してタスクを作成します。

タスクオブジェクトの構造

プロパティタイプ必須説明
typeStringRequiredHCaptchaClassification
queriesList[string]Required画像をBase64エンコードし、“data:image/***; base64,“を含めないでください。
画像をリストとして組み立てます:[base64、base64、base64…]
questionStringRequired英語のみサポートされています。他の言語は自分で変換してください。
WARNING

queriesパラメータの画像数の説明

選択問題の場合、一度に認識できる画像は18枚だけです。

ボックスを描く問題の場合、一度に1つの画像しか認識できません。

サポートされるタイプ

サポートされている画像タイプは次の通りです:

タイプ質問
/hcaptcha/hcap_select.png椅子が含まれている各画像をクリックしてください
/hcaptcha/hcap_choice.pngアヒル$ペンギン$サメ$象
/hcaptcha/hcap_area.pngパンダをクリックしてください

例のリクエスト

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/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.....",
    ]
  }
}

例のレスポンス

{
  "errorId": 0,
  "errorCode": "",
  "status": "ready",
  "solution": {
    // 以下の回答をクリックしてください
    "objects": [
      true,
      false,
      false,
      true,
      true,
      false,
      true,
      true
    ],
    // ボックスを描く回答
    "box": [
      //x1
      198.2198,
      //y1
      629.8307,
      //x2
      851.69403,
      //y2
      817.2047
    ],
    "tags": [
      "アヒル",
      "ペンギン",
      "サメ",
      "象",
    ],
    "imageSize": [
      //高さ、幅
      1072,
      1000
    ]
  },
  "taskId": "5aa8be0c-94a5-11ec-80d7-00163f00a53c"
}

SDKリクエストの使用

# 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)