YesCaptcha 验证码识别平台：任务类型、真实成本和接入步骤

先确认你要解决的是不是验证码问题

按页面现象选任务类型

页面上看到什么	实际类型	任务类型	单价
”我不是机器人”复选框，点开是九宫格	reCAPTCHA v2	NoCaptchaTaskProxyless	15 点
没有复选框，点提交才弹图片	reCAPTCHA v2 隐形版	同上，加 "isInvisible": true	15 点
页面加载 recaptcha/enterprise.js	reCAPTCHA v2 企业版	RecaptchaV2EnterpriseTaskProxyless	20 点
无感验证，不弹任何东西，只要分数	reCAPTCHA v3	RecaptchaV3TaskProxyless	20 点
九宫格加”我是人类”标题	hCaptcha	HCaptchaTaskProxyless	30 点
右下角小框”确认您是真人”	Cloudflare Turnstile	TurnstileTaskProxyless	25 点
整页”请稍候…""正在检查您的浏览器”	Cloudflare 5 秒盾	CloudFlareTaskS2 / CloudFlareTaskS3	25 / 20 点
扭曲的英文字母数字	图片验证码	ImageToTextTaskMuggle	2 点
只想让程序告诉你该点哪几张图	图像识别	ReCaptchaV2Classification / HCaptchaClassification	6 / 8 点

YesCaptcha 一次识别多少钱

任务	点数	折合每千次
图片英数字	2	约 2 元
reCAPTCHA v2 token	15	约 15 元
Turnstile token	25	约 25 元
hCaptcha token	30	约 30 元

等级	累计充值	每次充值赠送
VIP 1	10 元	2%
VIP 2	100 元	5%
VIP 3	500 元	8%
VIP 4	1000 元	10%
VIP 5	2000 元	15%
VIP 6	3000 元	20%
VIP 7	6000 元	25%
VIP 8	12000 元	30%
VIP 9	24000 元	35%
VIP 10	48000 元	40%

接入：先查余额，再测一张图

• 国际节点 https://api.yescaptcha.com
• 国内节点 https://cn.yescaptcha.com

curl -s https://api.yescaptcha.com/getBalance \
  -H 'Content-Type: application/json' \
  -d '{"clientKey": "YOUR_CLIENT_KEY"}'

# Python 3.9+ | 依赖: pip install requests
# 运行: YESCAPTCHA_CLIENT_KEY=你的key python solve.py turnstile https://example.com/login 0x4AAAAAAA_SITE_KEY

import os
import sys
import time

import requests

CLIENT_KEY = os.environ["YESCAPTCHA_CLIENT_KEY"]
REGION = os.environ.get("YESCAPTCHA_REGION", "intl")

ENDPOINTS = {
    "intl": "https://api.yescaptcha.com",
    "cn": "https://cn.yescaptcha.com",
}
BASE = ENDPOINTS[REGION]

# 任务类型映射，用哪个填哪个
TASK_TYPES = {
    "turnstile": "TurnstileTaskProxyless",
    "recaptcha_v2": "NoCaptchaTaskProxyless",
    "hcaptcha": "HCaptchaTaskProxyless",
}


def call(method, payload):
    body = {"clientKey": CLIENT_KEY}
    body.update(payload)
    resp = requests.post(f"{BASE}/{method}", json=body, timeout=30)
    resp.raise_for_status()
    return resp.json()


def get_balance():
    return call("getBalance", {}).get("balance")


def solve(task_type, website_url, website_key, timeout=180, interval=5):
    created = call("createTask", {
        "task": {
            "type": task_type,
            "websiteURL": website_url,
            "websiteKey": website_key,
        }
    })

    if created.get("errorId") != 0:
        raise RuntimeError(
            f"createTask 失败: {created.get('errorCode')} {created.get('errorDescription')}"
        )

    # 同步类型（图片识别、图像分类）在这里就直接有结果了
    if "solution" in created:
        return created["solution"]

    task_id = created["taskId"]
    deadline = time.time() + timeout

    while time.time() < deadline:
        time.sleep(interval)
        result = call("getTaskResult", {"taskId": task_id})

        if result.get("errorId") != 0:
            raise RuntimeError(
                f"getTaskResult 失败: {result.get('errorCode')} {result.get('errorDescription')}"
            )

        status = result.get("status")
        if status == "ready":
            return result["solution"]
        # status == "processing" 时继续等，不要改参数重发

    # 超时：任务会由平台判定并退点，本地直接放弃这一次
    raise TimeoutError(f"taskId {task_id} 在 {timeout} 秒内没有返回结果")


def solve_with_fallback(task_type, website_url, website_key, fallbacks=()):
    """主类型失败时按顺序换备用线路，每次都重新建任务。"""
    candidates = [task_type, *fallbacks]
    last_error = None

    for candidate in candidates:
        try:
            return candidate, solve(candidate, website_url, website_key)
        except (RuntimeError, TimeoutError) as exc:
            # 并发超限不要立刻重试，先让已发出的请求回来
            if "ERROR_THREADS_MAXIMUM" in str(exc):
                time.sleep(2)
            last_error = exc

    raise RuntimeError(f"全部任务类型均失败，最后一个错误: {last_error}")


if __name__ == "__main__":
    if len(sys.argv) != 4 or sys.argv[1] not in TASK_TYPES:
        print("用法: solve.py <turnstile|recaptcha_v2|hcaptcha> <页面URL> <sitekey>")
        sys.exit(1)

    kind, url, sitekey = sys.argv[1], sys.argv[2], sys.argv[3]
    task_type = TASK_TYPES[kind]

    print("余额:", get_balance(), "点")

    fallbacks = {
        "turnstile": ["TurnstileTaskProxylessM1"],
        "recaptcha_v2": ["RecaptchaV2TaskProxyless"],
        "hcaptcha": ["HCaptchaTaskProxylessM1"],
    }[kind]

    used, solution = solve_with_fallback(task_type, url, sitekey, fallbacks)
    print("任务类型:", used)
    print("token:", solution.get("token"))
    # 返回里带了 userAgent 时，提交 token 必须用它，否则大概率被判定为无效
    print("userAgent:", solution.get("userAgent"))

不会写代码的那条路

几个会浪费钱和时间的地方

它在整条链路里的位置

• Grok Token 号池：CLIProxyAPI 加 grok-build-auth，用 Turnstile 打码：https://obvps.com/posts/grok-token-pool-cliproxyapi-yescaptcha-guide/
• NVIDIA Build 的 nvapi 批量注册，用 hCaptcha 打码：https://obvps.com/posts/nvidia-build-apikey-register-somanyapikeys-yescaptcha/

常见问题

识别失败扣钱吗

是人工打码还是机器识别

识别一次要多久

国内服务器该用哪个节点

用打码平台会导致目标网站封号吗

怎么开始