# 用 token 完成 reCAPTCHA

> 拿到 reCAPTCHA 的 token（gRecaptchaResponse）之后怎么用：原理、直接发请求提交（g-recaptcha-response 字段）、在浏览器里填入并调用回调函数，附 Google 演示页的完整 Python 示例。

Source: https://docs.yescaptcha.com/zh/guides/submit-recaptcha-token/ · Last verified: 2026-10-15

YesCaptcha 返回的 `gRecaptchaResponse` 就是你在网页上点完验证码后、Google 交给网页的那个结果。拿到它之后，你需要像浏览器一样把它**提交给目标网站**（不是提交给 Google 或 YesCaptcha），网站拿去向 Google 核实后放行。有两种做法：直接发请求提交，或者在浏览器里填进页面再提交。

## 原理

正常访问时的流程：

1.  网页加载 reCAPTCHA，用户完成验证；
2.  Google 给网页一个 token，网页把它放进 `g-recaptcha-response` 文本框（或交给回调函数）；
3.  用户提交表单，token 随表单发给网站服务器；
4.  网站服务器拿 token 向 Google 核实，通过就放行。

用 YesCaptcha 时，第 1、2 步由我们完成：你用 `websiteURL`、`websiteKey` 创建任务，拿到 token，然后从第 3 步接着做。

token 一次性使用，约 120 秒内有效，建议拿到后 60 秒内提交。

## 方法一：直接发请求提交（推荐）

1.  在浏览器里正常操作一次：按 F12 打开 Network 面板，完成验证码并提交，找到提交表单的那个请求。
2.  在请求的 Payload（或 Form Data）里找到携带 token 的字段，通常叫 `g-recaptcha-response`，token 以 `03A` 开头；有的网站会改名，例如 `grecaptcharesponse`、`captcha`。
3.  在你的程序里发一个一样的请求，把字段的值换成 YesCaptcha 返回的 token。其他字段、Cookie、请求头也要和浏览器的一致，网站往往同时检查它们。

Google 演示页的完整例子：先识别，再把 token 用 `g-recaptcha-response` 字段提交回演示页：

recaptcha_requests.py

```python
"""Solve reCAPTCHA v2 on Google's demo page and submit the token with plain HTTP (no browser).

Run:  pip install requests
      export YESCAPTCHA_CLIENT_KEY=your_client_key
      python recaptcha_requests.py
Each run creates one NoCaptchaTaskProxyless task (charged per the price list).
"""
import os
import time

import requests

CLIENT_KEY = os.environ["YESCAPTCHA_CLIENT_KEY"]
API = "https://api.yescaptcha.com"
WEBSITE_URL = "https://www.google.com/recaptcha/api2/demo"
WEBSITE_KEY = "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"

def call(method, payload):
    data = requests.post(f"{API}/{method}", json={"clientKey": CLIENT_KEY, **payload}, timeout=30).json()
    if data.get("errorId"):
        raise RuntimeError(f"{data.get('errorCode')}: {data.get('errorDescription')}")
    return data

def get_token():
    task = {"type": "NoCaptchaTaskProxyless", "websiteURL": WEBSITE_URL, "websiteKey": WEBSITE_KEY}
    task_id = call("createTask", {"task": task})["taskId"]
    for _ in range(36):  # poll every 5 seconds, for up to about 3 minutes
        time.sleep(5)
        result = call("getTaskResult", {"taskId": task_id})
        if result.get("status") == "ready":
            return result["solution"]["gRecaptchaResponse"]
    raise TimeoutError(task_id)

token = get_token()
print("token:", token[:40], "...")

# Submit the token the same way the browser does: the demo form posts the field
# "g-recaptcha-response" back to the page. Check your own site's request in DevTools > Network.
page = requests.post(WEBSITE_URL, data={"g-recaptcha-response": token}, timeout=30)
print("passed" if "Verification Success" in page.text else "not passed", page.status_code)
```

## 方法二：在浏览器里填入（Selenium 等）

用 Selenium、Playwright 之类的工具操作真实浏览器时：

1.  从页面读出 `data-sitekey`，用它创建任务拿到 token。
2.  把 token 写进页面里的 `g-recaptcha-response` 文本框。
3.  如果页面设置了回调函数（`data-callback="..."`），调用它并传入 token；有的网站只有调用了回调，提交按钮才会变成可点击。
4.  提交表单。

```js
// 第 2 步：写入 token（在页面里执行）
document.getElementById('g-recaptcha-response').value = 'TOKEN';
// 第 3 步：有回调函数时调用，例如 data-callback="onSuccess"
onSuccess('TOKEN');
```

页面上有多个 reCAPTCHA 时，文本框的 id 可能是 `g-recaptcha-response-1` 这样的；找不到这个文本框时，先手动完成一次验证，在 Elements 里搜 `03A`，看结果被放在哪里。回调函数怎么找见 [查找 reCAPTCHA 参数](https://docs.yescaptcha.com/zh/guides/find-recaptcha-parameters/#%E5%9B%9E%E8%B0%83%E5%87%BD%E6%95%B0)。

完整例子（Selenium 4）：

recaptcha_selenium.py

```python
"""Solve reCAPTCHA v2 on Google's demo page in a real browser with Selenium 4:
get a token from YesCaptcha, put it into the page, then submit the form.

Run:  pip install requests selenium
      export YESCAPTCHA_CLIENT_KEY=your_client_key
      python recaptcha_selenium.py
Each run creates one NoCaptchaTaskProxyless task (charged per the price list).
"""
import os
import time

import requests
from selenium import webdriver
from selenium.webdriver.common.by import By

CLIENT_KEY = os.environ["YESCAPTCHA_CLIENT_KEY"]
API = "https://api.yescaptcha.com"
WEBSITE_URL = "https://www.google.com/recaptcha/api2/demo"

def call(method, payload):
    data = requests.post(f"{API}/{method}", json={"clientKey": CLIENT_KEY, **payload}, timeout=30).json()
    if data.get("errorId"):
        raise RuntimeError(f"{data.get('errorCode')}: {data.get('errorDescription')}")
    return data

def get_token(website_url, website_key):
    task = {"type": "NoCaptchaTaskProxyless", "websiteURL": website_url, "websiteKey": website_key}
    task_id = call("createTask", {"task": task})["taskId"]
    for _ in range(36):
        time.sleep(5)
        result = call("getTaskResult", {"taskId": task_id})
        if result.get("status") == "ready":
            return result["solution"]["gRecaptchaResponse"]
    raise TimeoutError(task_id)

driver = webdriver.Chrome()  # Selenium 4 downloads a matching chromedriver automatically
try:
    driver.get(WEBSITE_URL)
    site_key = driver.find_element(By.CSS_SELECTOR, "[data-sitekey]").get_attribute("data-sitekey")
    token = get_token(WEBSITE_URL, site_key)

    # Put the token where reCAPTCHA keeps it ...
    driver.execute_script(
        "document.getElementById('g-recaptcha-response').value = arguments[0];", token
    )
    # ... and, if the page uses a callback (data-callback="..."), call it:
    callback = driver.find_element(By.CSS_SELECTOR, "[data-sitekey]").get_attribute("data-callback")
    if callback:
        driver.execute_script(f"window[{callback!r}](arguments[0]);", token)

    driver.find_element(By.ID, "recaptcha-demo-submit").click()
    time.sleep(2)
    print("passed" if "Verification Success" in driver.page_source else "not passed")
finally:
    driver.quit()
```

## reCAPTCHA v3

v3 没有复选框，网页在需要时调用 `grecaptcha.execute(网站密钥, {action: '...'})` 拿 token，然后把 token 放进它自己的请求里（字段名由网站决定，常见 `g-recaptcha-response`、`token`、`recaptchaToken`）。做法和方法一相同：在 Network 里找到带 token 的请求照着发；创建任务时 `pageAction` 要和网页的 `action` 一致。

## 提交了还是不通过

-   token 过期了：拿到后尽快提交，不要超过 60 秒。
-   提交的不是网站检查的那个字段，或者漏了其他字段、Cookie：对照浏览器里的请求逐项检查。
-   网站同时检查 IP、User-Agent 等：用自带代理的类型（如 `NoCaptchaTask`），提交时走同一个代理。
-   v3 分数不够：确认 `pageAction`，或改用固定高分的类型，见 [reCAPTCHA v3](https://docs.yescaptcha.com/zh/tasks/recaptcha-v3/)。
-   网站的风控还看其他行为信号，token 方式通过率低时，可以改用 [图像识别](https://docs.yescaptcha.com/zh/tasks/recaptcha-classification/) 在浏览器里真实点击，或者用 [浏览器插件](https://docs.yescaptcha.com/zh/extension/)。