# YesCaptcha 文档 > YesCaptcha 是验证码识别 API。用 clientKey 和任务对象（reCAPTCHA v2/v3/企业版、hCaptcha、Cloudflare Turnstile、Cloudflare 5 秒盾、FunCaptcha、AWS WAF、图片英数字、图像识别）向 https://api.yescaptcha.com/createTask 发 JSON 请求，再每 5 秒调用 /getTaskResult 取结果（同步类型直接返回结果）。按任务扣点，1 元 = 1000 点，识别失败和超时自动退点。 - Home: https://docs.yescaptcha.com/zh/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/zh/llms-full.txt ## 入门 - [简介](https://docs.yescaptcha.com/zh/getting-started/introduction.md): YesCaptcha 是什么：通过 API 或浏览器插件识别 reCAPTCHA、hCaptcha、Turnstile、FunCaptcha 和图片验证码，按任务扣点，失败自动退点。 - [快速开始](https://docs.yescaptcha.com/zh/getting-started/quickstart.md): 5 分钟发出第一个 YesCaptcha 请求：注册、复制 clientKey、充值，再用 curl、Python 或 Node.js 识别一张图片验证码（ImageToTextTaskOcrBase，同步返回，每次 2 点）。 - [接入地址](https://docs.yescaptcha.com/zh/getting-started/endpoints.md): YesCaptcha API 的两个节点：国际节点 api.yescaptcha.com 和国内节点 cn.yescaptcha.com；只接受 HTTPS POST JSON，在同一个节点创建和查询任务。 - [计费与退点](https://docs.yescaptcha.com/zh/getting-started/billing.md): YesCaptcha 怎么扣点：1 元 = 1000 点，按任务类型扣点；识别失败和超时自动退点，返回错误的请求不扣点；余额须大于 10 点；图像识别上报失败约 24 小时后返点。 ## API 参考 - [请求与响应](https://docs.yescaptcha.com/zh/api/overview.md): YesCaptcha API 的通用约定：POST JSON、clientKey 鉴权、errorId 响应格式、同步和异步任务、每 5 秒轮询、110 秒超时、结果保留约 10 分钟、提示语言跟随 Accept-Language。 - [createTask 创建任务](https://docs.yescaptcha.com/zh/api/create-task.md): POST /createTask 创建一个验证码识别任务：请求参数（clientKey、task、softID）、校验顺序、异步返回 taskId、同步直接返回 solution，余额须大于 10 点。 - [getTaskResult 获取结果](https://docs.yescaptcha.com/zh/api/get-task-result.md): POST /getTaskResult 查询异步任务的结果：每 5 秒查一次，processing 继续等，ready 取 solution，出错停止轮询；任务最长约 110 秒，结果保留约 10 分钟，查询不扣点。 - [getBalance 查询余额](https://docs.yescaptcha.com/zh/api/get-balance.md): POST /getBalance 查询账户余额（点数，1 元 = 1000 点）以及开发者分成、邀请奖励余额，不扣点，可以用来验证 clientKey。 - [getSoftID 查询开发者 ID](https://docs.yescaptcha.com/zh/api/get-soft-id.md): POST /getSoftID 查询你的开发者 ID（softID）和累计分成金额；把 softID 放进别人使用你软件时的 createTask 请求，就能得到分成。 - [report 上报结果](https://docs.yescaptcha.com/zh/api/report.md): POST /report 上报任务的识别结果是否正确。图像识别类型在任务创建后 1 小时内上报失败，约 24 小时后结算返点；正确的结果也请上报，帮助改进识别。 - [useragent 获取 UA](https://docs.yescaptcha.com/zh/api/useragent.md): GET https://api.yescaptcha.com/useragent 返回当前建议使用的浏览器 User-Agent（纯文本），hCaptcha 任务的 userAgent 只接受这个值。 - [错误码](https://docs.yescaptcha.com/zh/api/errors.md): YesCaptcha API 全部错误码的含义和处理办法：请求格式、账户余额、并发与暂停、任务结果、网站参数、图片、代理、服务端。返回错误的请求不扣点。 - [并发限制与自动暂停](https://docs.yescaptcha.com/zh/api/rate-limits.md): YesCaptcha 的并发限制（ERROR_THREADS_MAXIMUM，不扣点、不计入暂停）、错误过多时的自动暂停（一分钟 100 次暂停 5 分钟，ERROR_IP_BLOCKED_5MIN）和无效参数缓存（cached）。 ## 任务类型 - [任务类型与价格](https://docs.yescaptcha.com/zh/tasks.md): YesCaptcha 全部公开任务类型的价格（点数，1 元 = 1000 点）和返回方式：返回 token 的 reCAPTCHA、hCaptcha、Turnstile、FunCaptcha，返回 Cookie 的 5 秒盾，返回识别结果的图片英数字和图像识别。 - [reCAPTCHA v2](https://docs.yescaptcha.com/zh/tasks/recaptcha-v2.md): 用 YesCaptcha 获取 reCAPTCHA v2（普通版、隐形版、企业版）的 token：任务类型和价格、请求参数、curl/Python/Node.js 示例和返回结果。 - [reCAPTCHA v3](https://docs.yescaptcha.com/zh/tasks/recaptcha-v3.md): 用 YesCaptcha 获取 reCAPTCHA v3（含企业版）的 token：pageAction 怎么填，固定分数 0.7、0.9 的类型，任务类型和价格、参数、示例和返回结果。 - [hCaptcha](https://docs.yescaptcha.com/zh/tasks/hcaptcha.md): 用 YesCaptcha 获取 hCaptcha 的 token：HCaptchaTaskProxyless、HCaptchaTaskProxylessM1 和自带代理的 HCaptchaTask，userAgent、rqdata 怎么填，返回的 respKey 怎么用。 - [Cloudflare Turnstile](https://docs.yescaptcha.com/zh/tasks/turnstile.md): 用 YesCaptcha 获取 Cloudflare Turnstile 的 token：TurnstileTaskProxyless、TurnstileTaskProxylessM1 和自带代理的 TurnstileTask，参数、示例和返回结果；和 5 秒盾的区别。 - [Cloudflare 5 秒盾](https://docs.yescaptcha.com/zh/tasks/cloudflare-challenge.md): 用 YesCaptcha 通过 Cloudflare 的"请稍候"检查页（5 秒盾），拿到 cf_clearance 等 Cookie 和 User-Agent：CloudFlareTaskS2、CloudFlareTaskS3（不推荐），代理要求和使用方法。 - [FunCaptcha](https://docs.yescaptcha.com/zh/tasks/funcaptcha.md): 用 YesCaptcha 获取 FunCaptcha（Arkose Labs）的 token：FunCaptchaTaskProxylessM1、自带代理的 FunCaptchaTask 和 FunCaptchaTaskProxyless，websitePublicKey、子域名和 blob 数据怎么填。 - [图片英数字识别](https://docs.yescaptcha.com/zh/tasks/image-to-text.md): 用 YesCaptcha 识别图片里的英文和数字：ImageToTextTaskOcrBase、ImageToTextTaskMuggle 同步返回，ImageToTextTask、ImageToTextTaskM1 异步并支持大小写、纯数字、算式等要求；可以定制模型。 - [reCAPTCHA v2 图像识别](https://docs.yescaptcha.com/zh/tasks/recaptcha-classification.md): 用 YesCaptcha 识别 reCAPTCHA v2 的图片题（ReCaptchaV2Classification）：上传 3x3、4x4 或 1x1 图片和题目 ID，同步返回要点击的格子；按图片大小计价，题目 ID 对照表。 - [hCaptcha 图像识别](https://docs.yescaptcha.com/zh/tasks/hcaptcha-classification.md): 用 YesCaptcha 识别 hCaptcha 的图片题（HCaptchaClassification）：九宫格选择、点击指定位置、拖动到指定位置、动画题；同步返回，没识别出目标时不扣点。 - [FunCaptcha 图像识别](https://docs.yescaptcha.com/zh/tasks/funcaptcha-classification.md): 用 YesCaptcha 识别 FunCaptcha（Arkose Labs）的图片题（FunCaptchaClassification）：上传 6 宫格图片和英文题目，同步返回应该选第几张；支持的题目示例。 - [AWS WAF / bCaptcha 图像识别](https://docs.yescaptcha.com/zh/tasks/aws-bcaptcha-classification.md): 用 YesCaptcha 识别 AWS WAF CAPTCHA 和 bCaptcha 的九宫格图片题（AwsClassification、bCaptchaClassification）：上传整张图和题目，同步返回要点击的格子。 ## 浏览器插件 - [YesCaptcha 人机助手](https://docs.yescaptcha.com/zh/extension.md): YesCaptcha 人机助手（浏览器插件）：在 Chrome、Firefox 里自动识别并点击 reCAPTCHA、hCaptcha、FunCaptcha、AWS WAF 等验证码。插件免费，按识别用到的 API 扣点；商店链接和安装包下载。 ## 教程 - [判断验证码类型](https://docs.yescaptcha.com/zh/guides/identify-captcha.md): 怎么判断网页上是哪种验证码：reCAPTCHA v2、v2 隐形版、v3、企业版，hCaptcha，Cloudflare Turnstile 和 5 秒盾的区别，以及对应用哪个 YesCaptcha 任务类型。 - [查找 reCAPTCHA 参数](https://docs.yescaptcha.com/zh/guides/find-recaptcha-parameters.md): 怎么找 reCAPTCHA 的 websiteKey（sitekey）、websiteURL、v3 的 pageAction 和回调函数：在开发者工具的 Network、Sources、Console 里查找，附自动查找脚本。 - [查找 hCaptcha 参数](https://docs.yescaptcha.com/zh/guides/find-hcaptcha-parameters.md): 怎么找 hCaptcha 的 websiteKey（sitekey）、websiteURL 和企业版的 rqdata：在网页源码搜 data-sitekey，或在 Network 里找 checksiteconfig、getcaptcha 请求。 - [查找 Turnstile 参数](https://docs.yescaptcha.com/zh/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/zh/guides/submit-recaptcha-token.md): 拿到 reCAPTCHA 的 token（gRecaptchaResponse）之后怎么用：原理、直接发请求提交（g-recaptcha-response 字段）、在浏览器里填入并调用回调函数，附 Google 演示页的完整 Python 示例。 - [reCAPTCHA v2 图像识别模拟点击（Selenium）](https://docs.yescaptcha.com/zh/guides/recaptcha-click-selenium.md): 用 Python Selenium 4 和 ReCaptchaV2Classification 在浏览器里自动点击 reCAPTCHA v2 的图片题：触发验证码、读取题目和图片、调用识别接口、点击格子、提交，完整示例代码。 - [hCaptcha 图像识别模拟点击（Selenium）](https://docs.yescaptcha.com/zh/guides/hcaptcha-click-selenium.md): 用 Python Selenium 4 和 HCaptchaClassification 在浏览器里自动完成 hCaptcha 的九宫格图片题：点复选框、读题目和 9 张图片、调用识别接口、点击、提交，完整示例代码。 ## 示例代码 - [示例代码与 SDK](https://docs.yescaptcha.com/zh/samples.md): YesCaptcha 的可运行示例代码（Python、Node.js、curl、C#、易语言）和网友提供的非官方 SDK（Python、Node.js、Go）。 - [Python](https://docs.yescaptcha.com/zh/samples/python.md): YesCaptcha 的 Python 示例：查询余额、识别图片验证码、可复用的客户端类（创建任务、每 5 秒轮询）、asyncio 并发控制，以及 requests 和 Selenium 提交 reCAPTCHA。 - [Node.js](https://docs.yescaptcha.com/zh/samples/nodejs.md): YesCaptcha 的 Node.js 示例（Node.js 18+，用自带的 fetch，不需要第三方库）：查询余额、识别图片验证码、可复用的客户端类（创建任务、每 5 秒轮询）。 - [C#](https://docs.yescaptcha.com/zh/samples/csharp.md): YesCaptcha 的 C# 示例（.NET 6+，HttpClient + System.Text.Json）：查询余额，创建 reCAPTCHA v2 任务并每 5 秒轮询结果。 - [易语言](https://docs.yescaptcha.com/zh/samples/easy-language.md): 网友提供的 YesCaptcha 易语言示例：reCAPTCHA、hCaptcha 模拟点击，FunCaptcha 图像识别，reCAPTCHA token 提交；下载包和调用接口的要点。 ## 账户 - [充值与 VIP](https://docs.yescaptcha.com/zh/account/recharge.md): YesCaptcha 怎么充值（微信支付、支付宝、PayPal、加密货币），1 元 = 1000 点；累计充值自动升级 VIP 1 到 VIP 10，之后每次充值按比例赠送点数。 - [邀请奖励](https://docs.yescaptcha.com/zh/account/referral.md): YesCaptcha 邀请奖励：邀请的用户注册即获得 VIP（你的等级减 1，VIP1 到 VIP6），你得到对方消费金额的 20%（同时有开发者分成时各得一半），可转为余额或满 100 元在后台申请提现。 - [开发者分成](https://docs.yescaptcha.com/zh/account/developer.md): YesCaptcha 开发者分成：你开发的软件或插件在用户的请求里带上你的 softID，你得到用户消费金额的 20%（同时有邀请人时各得 10%），可转为余额或满 100 元在后台申请提现。 ## 帮助 - [常见问题](https://docs.yescaptcha.com/zh/help/faq.md): YesCaptcha 常见问题：识别失败扣不扣点、token 多久有效、通过率、是人工还是机器识别、会不会封号、一个 clientKey 能否多处使用、选哪个节点、插件和 API 的区别。 - [连接与网络问题](https://docs.yescaptcha.com/zh/help/troubleshooting.md): 连不上 YesCaptcha API 怎么办：Failed to establish a new connection、DNS 解析失败、代理软件干扰、SSL 证书错误（Certificate has expired、SSLEOFError）的排查步骤。 - [联系我们](https://docs.yescaptcha.com/zh/help/contact.md): 联系 YesCaptcha 客服：微信、QQ、WhatsApp、LINE、Telegram @yescaptcha_official、邮箱 yescaptcha@gmail.com，服务时间 UTC+8 9:00–21:00。 - [服务更新记录](https://docs.yescaptcha.com/zh/changelog.md): YesCaptcha 对用户有影响的变化，按日期记录：新上线和下线的任务类型、计费和返点规则、并发限制、文档迁移。从 2026-10 开始记。 ## Other languages - [English](https://docs.yescaptcha.com/en/llms.txt)