# reCAPTCHA v2 画像認識

> YesCaptcha で reCAPTCHA v2 の画像問題（ReCaptchaV2Classification）を認識。3x3、4x4、1x1 の画像と問題 ID を送信すると、クリックするマスが同期で返ります。料金は画像サイズ別、問題 ID 対応表つき。

Source: https://docs.yescaptcha.com/ja/tasks/recaptcha-classification/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/tasks/recaptcha-classification/

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

> **ヒント:** クリック処理を自分で書きたくない場合は、このインターフェースを使って自動でクリックする [ブラウザ拡張機能](https://docs.yescaptcha.com/ja/extension.md) を利用できます。

- POST `https://api.yescaptcha.com/createTask` (グローバルエンドポイント)
- POST `https://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

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

## 返り値

3x3、4x4：

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

1x1 小画像：

```json
{
  "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 から始まり、左から右、上から下の順です。

![3x3 グリッドのマス番号 0 から 8](https://docs.yescaptcha.com/_astro/recaptcha-3x3-index.C2AG6XA0_1qgyOb.webp)

![4x4 グリッドのマス番号 0 から 15](https://docs.yescaptcha.com/_astro/recaptcha-4x4-index.CE_Q3Ngp_Z1pmx9g.webp)

## 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](https://docs.yescaptcha.com/ja/api/report.md) で報告できます。約 24 時間後に返金が確定します。ルールは [課金と返金](https://docs.yescaptcha.com/ja/getting-started/billing.md) を参照してください。認証に成功した場合も、report で `isSuccess: true` を報告してください。

## 関連チュートリアル

-   [reCAPTCHA v2 画像認識によるクリックのシミュレーション（Selenium）](https://docs.yescaptcha.com/ja/guides/recaptcha-click-selenium.md)
-   [reCAPTCHA v2（token を返す）](https://docs.yescaptcha.com/ja/tasks/recaptcha-v2.md)