reCAPTCHA v2 画像認識

ReCaptchaV2Classification は reCAPTCHA v2 に表示される画像問題を認識します。画像と問題 ID を送信すると、クリックすべきマスが返るので、ブラウザ上でのクリックはご自身のプログラムで行います。token は返しません。同期で結果が返り、createTask を 1 回呼ぶだけで取得できます。3x3、4x4 の画像は 1 枚あたり 6 ポイント（約 $0.90 / 1k）、1x1 の小さな画像はそれより安くなります（下表参照）。

ヒント

クリック処理を自分で書きたくない場合は、このインターフェースを使って自動でクリックする ブラウザ拡張機能 を利用できます。

POSThttps://api.yescaptcha.com/createTaskグローバルエンドポイントコピー

POSThttps://cn.yescaptcha.com/createTask中国エンドポイントコピー

タイプと料金

タスクタイプ	価格	返却方式	備考
ReCaptchaV2Classification	$0.90 / 1k; 6 ポイント/タスク · ¥6 / 1k	同期	1x1 のタイル（100x100）は 2 ポイント、3x3（300x300）と 4x4（450x450）は 6 ポイント

米ドル価格は US$1 ≈ ¥6.67 での概算です。タスクはポイントで課金されます。

リクエストパラメータ

フィールド	型	必須	説明
type	string	はい	タスクタイプ。値はこのページの「タイプと料金」を参照してください
image	string	はい	問題画像の Base64 エンコード文字列。data: のプレフィックスは含めないでください
question	string	はい	/m/0k4j のような問題 ID。このページの「問題 ID」を参照してください
confidence	number	いいえ	信頼度のしきい値（0〜1）。3x3 の画像にのみ使用されます。指定すると（0.5 から試すのがおすすめ）、この値を超えるすべてのタイルが返されます。省略すると、可能性の高い上位 3 つのタイルが返されます

注意

画像は下表の標準サイズに縮小・拡大してください。サーバーはサイズから問題の種類を判断します。

問題の種類	画像サイズ	返り値
3x3 グリッド（「該当する画像をすべて選択」）	300 × 300	objects：クリックするマス
4x4 グリッド（「該当するタイルをすべて選択」）	450 × 450	objects：クリックするマス
1x1 小画像（3x3 をクリックした後に更新されて表示される単一の画像）	100 × 100	hasObject：この画像をクリックすべきか

スクリーンショットの場合は問題文で判断してください。3x3 は「該当する画像をすべて選択」（Select all images with …）、4x4 は「該当するタイルをすべて選択」（Select all squares with …）です。

リクエスト例

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

返り値

3x3、4x4：

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [1, 5, 8],
    "type": "multi"
  },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

1x1 小画像：

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "hasObject": true,
    "type": "single"
  }
}

フィールド	型	説明
objects	array	クリックするタイルのインデックス。0 から始まり、左から右、上から下の順です
hasObject	boolean	1x1 のタイルの場合に返されます。タイルに対象が含まれているかどうかを示します
type	string	問題タイプ: multi(3x3 または 4x4 の画像。objects を参照)、single(1x1 のタイル。hasObject を参照)。hCaptcha のドラッグ問題は drag です

マスの番号は 0 から始まり、左から右、上から下の順です。

confidence：該当するマスを一度にすべて取得

3x3 の問題はクリック後に 1x1 の小画像が更新表示され、続けて判定が必要になることがあります。小画像の取得が難しい場合（モバイル端末での開発など）は、confidence を指定できます。

• 指定しない場合、3x3 の画像ではスコアが最も高い 3 つのマスを返します（reCAPTCHA は最低 3 つのクリックを要求します）。
• 指定した場合（0.5 を推奨）、この値を超えるスコアのマスをすべて返します。3 つより多くなることも少なくなることもあり、該当がなければ空配列が返ります。これにより 1x1 小画像を別途キャプチャする必要がなくなります。
• 4x4 と 1x1 の画像には効果がありません。

問題 ID

question には問題文ではなく、問題の ID（/m/ で始まるもの）を指定します。ID は、reCAPTCHA が問題を読み込むリクエスト（reload または userverify）のレスポンスに、画像と一緒に含まれています。下表はよくある問題です。中国語の表記は参考用です。

全 16 種類

問題 ID	問題文（英語）
/m/0pg52	taxis
/m/01bjv	bus
/m/04_sv	motorcycles
/m/013xlm	tractors
/m/01jk_4	chimneys
/m/014xcs	crosswalks
/m/015qff	traffic lights
/m/0199g	bicycles
/m/015qbp	parking meters
/m/0k4j	cars
/m/015kr	bridges
/m/019jd	boats
/m/0cdl1	palm trees
/m/09d_r	mountains or hills
/m/01pns0	fire hydrant
/m/01lynh	stairs

ERROR_UNKNOWN_QUESTION が返る場合は、ID が誤っているか、この問題が未対応です。ERROR_UNKNOW_450x450_QUESTION が返る場合は、この問題が 4x4 画像に未対応です。ページ上で更新して別の問題に切り替えてください。

報告と返金

クリック後に認証が失敗した場合は、1 時間以内に report で報告できます。約 24 時間後に返金が確定します。ルールは 課金と返金 を参照してください。認証に成功した場合も、report で isSuccess: true を報告してください。

関連チュートリアル

• reCAPTCHA v2 画像認識によるクリックのシミュレーション（Selenium）
• reCAPTCHA v2（token を返す）