# YesCaptcha Docs

> YesCaptcha はキャプチャ認識 API です。1 つの JSON インターフェースで reCAPTCHA、hCaptcha、Cloudflare Turnstile、FunCaptcha、AWS WAF、画像キャプチャを認識できます。課金はタスク単位で、認識に失敗した場合やタイムアウトした場合は自動で返金されます。

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/ja/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/ja/llms-full.txt

## はじめに

- [はじめに](https://docs.yescaptcha.com/ja/getting-started/introduction.md): YesCaptcha とは。API またはブラウザ拡張機能で reCAPTCHA、hCaptcha、Turnstile、FunCaptcha、画像キャプチャを認識し、タスクごとにポイントを課金、失敗時は自動で返金します。
- [クイックスタート](https://docs.yescaptcha.com/ja/getting-started/quickstart.md): 5 分で最初の YesCaptcha リクエストを送信します。アカウント登録、clientKey のコピー、チャージを行い、curl、Python、Node.js で画像キャプチャを認識します（ImageToTextTaskOcrBase、同期で結果を返し、1 回 2 ポイント）。
- [エンドポイント](https://docs.yescaptcha.com/ja/getting-started/endpoints.md): YesCaptcha API の2つのエンドポイント、グローバルの api.yescaptcha.com と中国の cn.yescaptcha.com。HTTPS の POST と JSON のみ対応。タスクの作成と取得は同じエンドポイントで行います。
- [課金と返金](https://docs.yescaptcha.com/ja/getting-started/billing.md): YesCaptcha の課金方法。1,000 ポイント = ¥1 で、タスクタイプごとに固定価格で課金されます。解析に失敗したタスクやタイムアウトしたタスクは返金され、エラーを返したリクエストには課金されません。残高は 10 ポイントより多い必要があります。画像認識で失敗を報告した場合は、約 24 時間後に返金されます。

## API リファレンス

- [リクエストとレスポンス](https://docs.yescaptcha.com/ja/api/overview.md): YesCaptcha API の共通ルール。POST JSON、clientKey による認証、errorId のレスポンス形式、同期・非同期タスク、5 秒ごとのポーリング、110 秒のタイムアウト、結果の保持期間（約 10 分）、Accept-Language によるメッセージ言語。
- [createTask タスクの作成](https://docs.yescaptcha.com/ja/api/create-task.md): POST /createTask でキャプチャ認識タスクを作成します。リクエストパラメータ（clientKey、task、softID）、検証の順序、非同期タイプは taskId を返し、同期タイプは solution を直接返すこと、残高が 10 ポイントを超えている必要があることを説明します。
- [getTaskResult 結果の取得](https://docs.yescaptcha.com/ja/api/get-task-result.md): POST /getTaskResult は非同期タスクの結果を取得します。5 秒ごとに問い合わせ、processing の間は待機、ready になったら solution を読み取り、エラーが返ったらポーリングを止めます。タスクの処理時間は最長で約 110 秒、結果の保持期間は約 10 分で、問い合わせに課金はありません。
- [getBalance 残高の照会](https://docs.yescaptcha.com/ja/api/get-balance.md): POST /getBalance でアカウントの残高(ポイント、1,000 ポイント = ¥1)と、開発者収益分配・紹介報酬の残高を照会します。課金されないため、clientKey の確認にも使えます。
- [getSoftID 開発者 ID の照会](https://docs.yescaptcha.com/ja/api/get-soft-id.md): POST /getSoftID で開発者 ID(softID)と累計の収益分配額を照会します。他のユーザーがあなたのソフトウェアを使うときの createTask リクエストに softID を含めると、収益分配を受け取れます。
- [report 結果の報告](https://docs.yescaptcha.com/ja/api/report.md): POST /report でタスクの認識結果が正しかったかを報告します。成功も失敗も正直に報告してください。画像認識タイプはタスク作成後 1 時間以内に失敗を報告すると、約 24 時間後に返金が精算されます。
- [useragent（UA の取得）](https://docs.yescaptcha.com/ja/api/useragent.md): GET https://api.yescaptcha.com/useragent は、現在推奨されるブラウザの User-Agent をプレーンテキストで返します。hCaptcha タスクの userAgent フィールドで使用できるのはこの値だけです。
- [エラーコード](https://docs.yescaptcha.com/ja/api/errors.md): YesCaptcha API の全エラーコードの意味と対処方法を、リクエスト形式、アカウントと残高、同時実行と一時停止、タスク結果、サイトパラメータ、画像、プロキシ、サーバー側に分けて説明します。エラーを返したリクエストは課金されません。
- [同時実行数の上限と自動一時停止](https://docs.yescaptcha.com/ja/api/rate-limits.md): YesCaptcha の同時実行数の上限（ERROR_THREADS_MAXIMUM、課金なし、一時停止の対象外）、エラーが多すぎる場合の自動一時停止（1 分間に 100 回で 5 分間停止、ERROR_IP_BLOCKED_5MIN）、無効なパラメータのキャッシュ（cached）について説明します。

## タスクタイプ

- [タスクタイプと料金](https://docs.yescaptcha.com/ja/tasks.md): YesCaptcha で公開しているすべてのタスクタイプの料金(ポイント、1 元 = 1000 ポイント)と返却方式。token を返す reCAPTCHA・hCaptcha・Turnstile、Cookie を返す Cloudflare チャレンジページ、認識結果を返す画像の英数字認識と画像認識。
- [reCAPTCHA v2](https://docs.yescaptcha.com/ja/tasks/recaptcha-v2.md): YesCaptcha で reCAPTCHA v2(通常版・非表示版・Enterprise 版)の token を取得する方法。タスクタイプと料金、リクエストパラメータ、curl/Python/Node.js のサンプル、返却結果を説明します。
- [reCAPTCHA v3](https://docs.yescaptcha.com/ja/tasks/recaptcha-v3.md): YesCaptcha で reCAPTCHA v3(Enterprise 版を含む)の token を取得する方法。pageAction の指定方法、固定スコア 0.7・0.9 のタイプ、タスクタイプと料金、パラメータ、リクエスト例、返却結果を説明します。
- [hCaptcha](https://docs.yescaptcha.com/ja/tasks/hcaptcha.md): YesCaptcha で hCaptcha のトークンを取得します。HCaptchaTaskProxyless、HCaptchaTaskProxylessM1、独自プロキシを使う HCaptchaTask、userAgent と rqdata の指定方法、返される respKey の使い方を説明します。
- [Cloudflare Turnstile](https://docs.yescaptcha.com/ja/tasks/turnstile.md): YesCaptcha で Cloudflare Turnstile のトークンを取得します。TurnstileTaskProxyless、TurnstileTaskProxylessM1、独自プロキシを使う TurnstileTask のパラメーター、リクエスト例、返却結果と、Cloudflare チャレンジページとの違いを説明します。
- [Cloudflare チャレンジページ](https://docs.yescaptcha.com/ja/tasks/cloudflare-challenge.md): YesCaptcha で Cloudflare の「しばらくお待ちください」チェックページ(Cloudflare チャレンジページ)を通過し、cf_clearance などの Cookie、User-Agent、ページ内容を取得します。CloudFlareTaskS2、CloudFlareTaskS3 のパラメーター、プロキシの要件、返却結果、結果の使い方、よくあるエラーを解説します。
- [画像の英数字認識](https://docs.yescaptcha.com/ja/tasks/image-to-text.md): YesCaptcha で画像内の英字と数字を認識します。ImageToTextTaskOcrBase と ImageToTextTaskMuggle は同期で結果を返し、ImageToTextTask と ImageToTextTaskM1 は非同期で、大文字小文字の区別、数字のみ、計算式などの条件に対応します。モデルのカスタマイズも可能です。
- [reCAPTCHA v2 画像認識](https://docs.yescaptcha.com/ja/tasks/recaptcha-classification.md): YesCaptcha で reCAPTCHA v2 の画像問題（ReCaptchaV2Classification）を認識。3x3、4x4、1x1 の画像と問題 ID を送信すると、クリックするマスが同期で返ります。料金は画像サイズ別、問題 ID 対応表つき。
- [hCaptcha 画像認識](https://docs.yescaptcha.com/ja/tasks/hcaptcha-classification.md): YesCaptcha で hCaptcha の画像問題（HCaptchaClassification）を認識します。3×3 グリッドの選択、指定位置のクリック、指定位置へのドラッグ、アニメーション問題に対応。同期で結果を返し、対象が見つからなかった場合は課金されません。
- [FunCaptcha 画像認識](https://docs.yescaptcha.com/ja/tasks/funcaptcha-classification.md): YesCaptcha で FunCaptcha（Arkose Labs）の画像問題（FunCaptchaClassification）を認識します。問題画像（6 分割グリッド、または左右に結合した矢印問題）と英語の問題文を送信すると、選ぶべき画像の番号が同期で返ります。すべての問題タイプに対応しています。
- [AWS WAF / bCaptcha 画像認識](https://docs.yescaptcha.com/ja/tasks/aws-bcaptcha-classification.md): YesCaptcha で AWS WAF CAPTCHA と bCaptcha の 3×3 グリッド画像問題を認識します（AwsClassification、bCaptchaClassification）。画像全体と問題文を送信すると、クリックするマスが同期で返ります。

## ブラウザ拡張機能

- [YesCaptcha Assistant](https://docs.yescaptcha.com/ja/extension.md): YesCaptcha Assistant（ブラウザ拡張機能）は、Chrome と Firefox で reCAPTCHA、hCaptcha、FunCaptcha、AWS WAF などのキャプチャを自動で認識してクリックします。拡張機能は無料で、使用した API の分だけ課金されます。ストアのリンク、インストールパッケージのダウンロード、Chrome・BitBrowser・Kiwi Browser でのインストール動画を掲載しています。

## ガイド

- [キャプチャの種類を見分ける](https://docs.yescaptcha.com/ja/guides/identify-captcha.md): ページ上のキャプチャが何かを見分ける方法。reCAPTCHA v2、v2 非表示版、v3、エンタープライズ版、hCaptcha、Cloudflare Turnstile と Cloudflare チャレンジページの違い、対応する YesCaptcha のタスクタイプを説明します。
- [reCAPTCHA パラメータの調べ方](https://docs.yescaptcha.com/ja/guides/find-recaptcha-parameters.md): reCAPTCHA の websiteKey（sitekey）、websiteURL、v3 の pageAction、コールバック関数を、開発者ツールの Network・Sources・Console で調べる方法です。自動検出スクリプト付き。
- [hCaptcha のパラメータの見つけ方](https://docs.yescaptcha.com/ja/guides/find-hcaptcha-parameters.md): hCaptcha の websiteKey（sitekey）、websiteURL、Enterprise 版の rqdata の見つけ方。ページソースで data-sitekey を検索するか、Network パネルで checksiteconfig や getcaptcha のリクエストを探します。
- [Turnstile パラメータの調べ方](https://docs.yescaptcha.com/ja/guides/find-turnstile-parameters.md): Cloudflare Turnstile の websiteKey（sitekey、0x で始まる）と websiteURL の調べ方。ページのソースで data-sitekey や turnstile.render を検索するか、Network パネルで challenges.cloudflare.com へのリクエストを確認します。
- [token で reCAPTCHA を通過する](https://docs.yescaptcha.com/ja/guides/submit-recaptcha-token.md): reCAPTCHA の token（gRecaptchaResponse）を取得した後の使い方。仕組み、リクエストを直接送信する方法（g-recaptcha-response フィールド）、ブラウザに入力してコールバック関数を呼び出す方法を、Google のデモページを使った Python の完全なサンプル付きで解説します。
- [reCAPTCHA v2 画像認識によるクリック操作（Selenium）](https://docs.yescaptcha.com/ja/guides/recaptcha-click-selenium.md): Python Selenium 4 と ReCaptchaV2Classification を使い、ブラウザ上で reCAPTCHA v2 の画像問題を自動でクリックします。キャプチャの表示、問題文と画像の取得、認識 API の呼び出し、マスのクリック、送信までの完全なサンプルコードを掲載しています。
- [hCaptcha 画像認識によるクリック操作の自動化（Selenium）](https://docs.yescaptcha.com/ja/guides/hcaptcha-click-selenium.md): Python Selenium 4 と HCaptchaClassification を使い、ブラウザ上で hCaptcha の 3×3 グリッド画像チャレンジを自動で突破する方法を解説します。チェックボックスのクリック、問題文と 9 枚の画像の取得、認識 API の呼び出し、クリック、送信まで、完全なサンプルコード付きです。

## サンプルコード

- [サンプルコードと SDK](https://docs.yescaptcha.com/ja/samples.md): YesCaptcha の実行可能なサンプルコード（Python、Node.js、curl、C#、易語言）と、ユーザー提供の非公式 SDK（Python、Node.js、Go）。
- [Python](https://docs.yescaptcha.com/ja/samples/python.md): YesCaptcha の Python サンプル。残高の確認、画像キャプチャの認識、再利用できるクライアントクラス（タスク作成、5 秒ごとのポーリング）、asyncio による同時実行数の制御、requests と Selenium による reCAPTCHA の送信。
- [Node.js](https://docs.yescaptcha.com/ja/samples/nodejs.md): YesCaptcha の Node.js サンプル(Node.js 18 以上、組み込みの fetch を使用、外部ライブラリ不要)。残高の確認、画像キャプチャの認識、再利用できるクライアントクラス(タスクの作成、5 秒ごとのポーリング)。
- [C#](https://docs.yescaptcha.com/ja/samples/csharp.md): YesCaptcha の C# サンプル（.NET 6+、HttpClient + System.Text.Json）：残高を照会し、reCAPTCHA v2 タスクを作成して 5 秒ごとに結果をポーリングします。
- [易語言（Easy Language）](https://docs.yescaptcha.com/ja/samples/easy-language.md): ユーザー提供の YesCaptcha 易語言サンプル。reCAPTCHA・hCaptcha のクリック操作、FunCaptcha の画像認識、reCAPTCHA token の送信。ダウンロードと API 呼び出しのポイント。

## アカウント

- [複数の clientKey：上限、IP 許可リスト、有効期限](https://docs.yescaptcha.com/ja/account/client-keys.md): 1 つの YesCaptcha アカウントで最大 20 個の clientKey を使え、すべて同じアカウント残高から課金されます。各 clientKey に、利用上限（毎日・毎週・毎月、または一括の合計。北京時間でリセット）、IP 許可リスト、有効期限を個別に設定でき、数秒で反映されます。
- [チャージと VIP](https://docs.yescaptcha.com/ja/account/recharge.md): YesCaptcha のチャージ方法（WeChat Pay、Alipay、PayPal、暗号資産）。1,000 ポイント = ¥1。累計チャージ額に応じて VIP 1 から VIP 10 まで自動でアップグレードされ、以降のチャージにはボーナスポイントが付与されます。
- [紹介プログラム](https://docs.yescaptcha.com/ja/account/referral.md): YesCaptcha の紹介プログラム。紹介したユーザーは登録時に VIP を獲得し（あなたのレベル−1、VIP 1〜VIP 6）、あなたは相手の利用金額の 20% を受け取れます（開発者収益分配も適用される場合は各 10%）。報酬は残高に振り替えるか、100 元から ダッシュボードで出金を申請できます。
- [開発者収益分配](https://docs.yescaptcha.com/ja/account/developer.md): YesCaptcha の開発者収益分配：開発したソフトウェアやプラグインがユーザーに代わって送信するリクエストに softID を含めると、ユーザーの利用金額の 20% を受け取れます（紹介者もいる場合は 10% ずつ）。ダッシュボードで残高に振り替えるか、100 元から出金を申請できます。

## ヘルプ

- [よくある質問](https://docs.yescaptcha.com/ja/help/faq.md): YesCaptcha のよくある質問。認識に失敗した場合の課金、token の有効期間、通過率、人手か機械か、アカウント停止の可能性、1 つの clientKey の複数環境での利用、エンドポイントの選び方、拡張機能と API の違い。
- [接続とネットワークの問題](https://docs.yescaptcha.com/ja/help/troubleshooting.md): YesCaptcha API に接続できないときの対処法。Failed to establish a new connection、DNS 解決の失敗、プロキシソフトの干渉、SSL 証明書エラー（Certificate has expired、SSLEOFError）の切り分け手順。
- [お問い合わせ](https://docs.yescaptcha.com/ja/help/contact.md): YesCaptcha サポートへの連絡方法：WeChat、QQ、WhatsApp、LINE、Telegram @yescaptcha_official、メール yescaptcha@gmail.com。対応時間は UTC+8 9:00–21:00。
- [サービス更新履歴](https://docs.yescaptcha.com/ja/changelog.md): YesCaptcha のユーザーに影響する変更を日付順に記録します。新規公開・終了したタスクタイプ、課金と報告による返金のルール、同時実行数の上限、ドキュメントの移行など。2026-10 から記録しています。

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)