logo
bars
Trả theo lần giải · API

Giải reCAPTCHA v3

CapMonster Cloud là dịch vụ tự động giải reCAPTCHA v3 qua API. Chỉ định điểm tối thiểu (minScore), nhận token sẵn sàng sử dụng và tiếp tục quy trình tự động hóa mà không cần thao tác thủ công.
Dùng thử miễn phí: số dư thử $0.10 ↓
Thời gian phản hồi API
≤ 2 s
Tỷ lệ thành công
lên tới 99%
trên 1000 token
$ 0.90

Giá dịch vụ giải reCAPTCHA v3

CAPTCHA
Giá (USD)
$ 0.90
1000 token

Google reCAPTCHA v3 là gì

reCAPTCHA v3 là cơ chế bảo vệ vô hình của Google giúp phân biệt người dùng thật với bot mà không cần hộp kiểm “Tôi không phải là robot”. Trên trang có một script ẩn chạy, phân tích hành vi của khách truy cập và đưa ra điểm tin cậy (score) từ 0.0 đến 1.0. Lập trình viên thiết lập một ngưỡng, nếu điểm thấp hơn ngưỡng đó thì có thể yêu cầu kiểm tra bổ sung hoặc chặn truy cập, nhờ đó tăng cường bảo mật mà không gây thêm thao tác cho người dùng.

1. Script ẩn

Một script được tải kèm site key chạy nền trên mọi trang dùng nó. Khách truy cập không thấy hộp kiểm và không cần thao tác gì.

2. Điểm tin cậy

Dựa trên dữ liệu hành vi đã thu thập, Google gán cho khách một điểm cho biết khả năng đó là người. Chủ site chọn ngưỡng.

3. Ngưỡng phía máy chủ

Site so sánh điểm với ngưỡng của mình. Nếu thấp hơn, site có thể yêu cầu xác minh thêm hoặc chặn yêu cầu.

Quy trình xác minh reCAPTCHA v3

Bước 1. Tải script
Trang tải script reCAPTCHA v3 kèm site key và gọi grecaptcha.execute cho một action.
Bước 2. Cấp token
Google trả về token cho action đó.
Bước 3. Gửi token về backend
Trang gửi token kèm dữ liệu form lên máy chủ. Token có hiệu lực khoảng 2 phút.
Bước 4. Siteverify
Máy chủ gửi secret key và token tới endpoint siteverify của Google.
Bước 5. Kiểm tra score và action
Máy chủ kiểm tra success là true, score đạt ngưỡng và action khớp. Token hợp lệ với score thấp vẫn có thể bị từ chối.

Điểm reCAPTCHA v3: ý nghĩa và cách đặt minScore

Điểm reCAPTCHA v3 từ 0.0 (có thể là bot) đến 1.0 (có thể là người). Google gợi ý ngưỡng 0.5. Quan sát lưu lượng thực trước khi áp dụng hoặc điều chỉnh.

Google hỗ trợ 11 mức điểm. Essentials miễn phí trả về 0.1, 0.3, 0.7 và 0.9; bật thanh toán mở khóa mọi mức và reason code. Điểm staging và tuần đầu có thể khác production.

Tham số CapMonster Cloud minScore (0.1–0.9) đặt điểm tối thiểu của token. Khớp với ngưỡng của trang; giá trị cao như 0.9 làm tăng lần thất bại.

pageAction phải khớp action trong grecaptcha.execute. Chỉ dùng chữ cái, chữ số, dấu gạch chéo và gạch dưới. Trang có thể từ chối lệch. Truyền cả minScore và pageAction.

Phạm vi điểm
0.0–1.0
Ngưỡng mặc định
0.5
minScore
0.1–0.9

Kiểm tra điểm reCAPTCHA v3: cách xem score

Kiểm tra điểm cần backend: score nằm trong phản hồi siteverify.

  1. 1. Trên trang thử nghiệm, dùng site key và gọi grecaptcha.execute với một action.

  2. 2. Gửi token và secret key từ backend tới https://www.google.com/recaptcha/api/siteverify.

  3. 3. So sánh score trả về với ngưỡng và kiểm tra action.

Thử trang demo reCAPTCHA v3 của chúng tôi mà không cần tự làm trang thử.

So sánh dịch vụ giải reCAPTCHA v3

Bảng liệt kê giá, thời gian phản hồi API và tỷ lệ thành công của bốn dịch vụ giải reCAPTCHA v3.

Tham sốCapMonster Cloud2CaptchaCapSolverDeathByCaptcha
Giá cho 1000 lần giải (từ)
$ 0.90$1.45$1.00$2.89
Thời gian phản hồi API
≤ 2 s≤ 2 s< 3 s≤ 3 s
Tỷ lệ giải thành công
lên tới 99%~77–92%~95–98%~64–90%

Tuyên bố: 2Captcha, CapSolver và DeathByCaptcha là thương hiệu của các chủ sở hữu tương ứng. CapMonster Cloud không liên kết với các tổ chức này. Chỉ số hiệu suất và so sánh giá dựa trên dữ liệu công khai và benchmark nội bộ ngày 28.09.2026.

Dùng thử miễn phí

$0.10

Người dùng mới nhận $0.10 số dư thử để trải nghiệm CapMonster Cloud.

  1. 1. Đăng ký tại CapMonster Cloud.

  2. 2. Nhắn hỗ trợ qua chat trực tiếp hoặc support@capmonster.cloud kèm email gắn với tài khoản của bạn.

Cách giải reCAPTCHA v3 thông qua CapMonster Cloud

CapMonster Cloud nhận tham số captcha, xử lý trên máy chủ và trả về token sẵn dùng. Chèn token này vào form để vượt kiểm tra mà không cần tương tác người dùng. Tác vụ RecaptchaV3TaskProxyless chạy trên máy chủ proxy của CapMonster Cloud, vì vậy bạn không truyền tham số proxy.

Tạo nhiệm vụ

Ở bước này, bạn gửi API key, loại captcha và các tham số của nó. Dịch vụ sẽ trả về một taskId duy nhất, sau này bạn có thể dùng để lấy kết quả.

Gửi yêu cầu API

Trong yêu cầu giải reCAPTCHA v3, bạn cần chỉ định các tham số sau:

Tham sốMô tả
type
stringBắt buộc
RecaptchaV3TaskProxyless
websiteURL
stringBắt buộc
địa chỉ trang nơi captcha được giải
websiteKey
stringBắt buộc
khóa định danh (sitekey) được chỉ định trên trang có captcha của trang web bạn
https://www.google.com/recaptcha/api.js?render=SITE_KEY
6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob
isEnterprise
booleanKhông bắt buộc
Với reCAPTCHA v3 Enterprise, đặt isEnterprise: true trong RecaptchaV3TaskProxyless (true/false hoặc 1/0). CapMonster Cloud xử lý như RecaptchaV3EnterpriseTask.
minScore
doubleKhông bắt buộc
có thể nhận giá trị từ 0.1 đến 0.9
pageAction
stringKhông bắt buộc
giá trị của tham số action được widget ReCaptcha của Google gửi đi. Giá trị mặc định: verify
grecaptcha.execute('site_key', {action: 'login_test'})
Chi tiết về các tham số và cách thu thập tự động có trong tài liệu CapMonster Cloud.
Địa chỉ gửi nhiệm vụ:
text
https://api.capmonster.cloud/createTask
Ví dụ yêu cầu:
json
{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
    "websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}
Phản hồi:
json
{
  "errorId":0,
  "taskId":407533072
}

Nhận kết quả

Sau khi tạo nhiệm vụ, hãy kiểm tra định kỳ trạng thái giải.
Địa chỉ để nhận kết quả:
text
https://api.capmonster.cloud/getTaskResult
Ví dụ yêu cầu:
json
{
  "clientKey":"API_KEY",
  "taskId": 407533072
}
Phản hồi:
json
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}
Phản hồi có userAgent
json
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
    "cookies": {
      "nocookies": "true"
    }
  }
}
QUAN TRỌNG
Trên một số trang, kết quả còn chứa userAgent. Hãy dùng UserAgent này khi gửi token hoặc xác nhận kết quả trên trang đích, ngay cả khi khác với trình duyệt hoặc tập lệnh của bạn.

Áp dụng token lên trang

Mã thông báo (token) nhận được (giá trị "gRecaptchaResponse") có thể được chèn vào một trường ẩn của form hoặc dùng để gọi hàm JS trên website nhằm xác nhận kết quả giải. Sau đó, máy chủ sẽ chấp nhận form như một form đã được điền hợp lệ. Để tự động hóa và kiểm thử, bạn có thể sử dụng Puppeteer, Selenium hoặc Playwright, cho phép mô phỏng thao tác người dùng, chèn token và gửi form.
Trên một số trang, kết quả còn chứa userAgent. Hãy dùng UserAgent này khi gửi token hoặc xác nhận kết quả trên trang đích, ngay cả khi khác với trình duyệt hoặc tập lệnh của bạn.
Thử trên trang demo

Cách tìm sitekey và pageAction

Một tác vụ reCAPTCHA v3 cần site key (websiteKey) và tên action (pageAction).

  1. 1. Chuột phải vào trang và chọn Inspect.

  2. 2. Trong Elements hoặc Network, tìm api.js?render=SITE_KEY. Giá trị sau render= là websiteKey. reCAPTCHA Enterprise dùng enterprise.js?render=SITE_KEY.

  3. 3. Tìm grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION là pageAction. Enterprise dùng grecaptcha.enterprise.execute. Nếu bỏ qua, tác vụ mặc định dùng verify.

  4. 4. Bắt grecaptcha.execute trong trình duyệt headless như Playwright để lấy cả hai giá trị. Xem ví dụ JavaScript, Python và C# trong tài liệu CapMonster Cloud.

SDK giải reCAPTCHA v3: Python, Node.js, C#

Dịch vụ CapMonster Cloud cung cấp các thư viện sẵn dùng cho Python, JavaScript (Node.js) và C# để tích hợp thuận tiện hơn.
Python
JavaScript
C#
python
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY")  # Chỉ định API key CapMonster Cloud của bạn
cap_monster_client = CapMonsterClient(options=client_options)
# Nếu cần, có thể kiểm tra số dư (balance)
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",  # URL trang có captcha của bạn
    websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",  # Thay bằng giá trị chính xác
    minScore=0.7,  # Ngưỡng tối thiểu của điểm tin cậy
    pageAction="myverify"  # Hành động trên trang (action)
)
async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)

Nhóm dùng solver reCAPTCHA v3 để làm gì

QA và kiểm thử end-to-end

Chạy luồng đăng ký, thanh toán và form trong CI/CD với Playwright, Puppeteer hoặc Selenium trên trang bạn sở hữu hoặc được phép kiểm thử.

Giám sát

Kiểm tra form và endpoint được bảo vệ vẫn hoạt động sau release và thay đổi ngưỡng.

Dữ liệu công khai

Thu thập dữ liệu công khai từ trang mở dùng kiểm tra dựa trên điểm.

Khả năng tiếp cận

Hỗ trợ quy trình hỗ trợ tự động trên site dùng kiểm tra bot ẩn.

Tác nhân AI

Tác nhân có thể yêu cầu token qua MCP khi luồng gặp captcha.

Chỉ dùng hợp pháp

Dùng CapMonster Cloud cho dữ liệu công khai và trên site bạn sở hữu hoặc được phép kiểm thử. Thu thập dữ liệu bên thứ ba sau đăng nhập hoặc paywall mà không có phép là bị cấm.

reCAPTCHA v3 và reCAPTCHA v3 Enterprise

Essentials4 mức
0.1 · 0.3 · 0.7 · 0.9

reCAPTCHA Enterprise dùng kiểm tra dựa trên điểm: Essentials trả về bốn mức.

Premium · Enterprise11 mức
Lý do cho điểm rủi ro được gán

Premium và Enterprise trả về 11, kèm lý do explainability cơ bản và nâng cao.

RecaptchaV3TaskProxylessisEnterprise: true

Với reCAPTCHA v3 Enterprise, đặt isEnterprise: true trong RecaptchaV3TaskProxyless (true/false hoặc 1/0). CapMonster Cloud xử lý như RecaptchaV3EnterpriseTask.

Xác minh token reCAPTCHA v3 trên trang của bạn

POST https://www.google.com/recaptcha/api/siteverify

secret=YOUR_SECRET_KEY
response=TOKEN

Trên trang của bạn, gửi secret và response tới https://www.google.com/recaptcha/api/siteverify. Token hết hạn sau 2 phút và dùng một lần. Kiểm tra success, score và action; Google gợi ý ngưỡng 0.5.

Xem Captcha API (Google reCAPTCHA v3) để có ví dụ Node.js và Python, xử lý lỗi và hành động dựa trên điểm.

Background

Lỗi reCAPTCHA v3 và cách khắc phục

Bug Icon

Sai website hoặc khóa

Captcha không tải được hoặc trả về lỗi invalid-input-secret.
Bug Icon

Hết thời gian chờ khi giải

Máy chủ không nhận được kết quả kịp thời, hãy tăng thời gian chờ.
Bug Icon

Token rỗng

Lỗi khi truyền kết quả lên trang.
Bug Icon

Kết quả success=false

Token đã hết hạn, bị dùng lại hoặc bị giả mạo. Để chẩn đoán, hãy bật log request và kiểm tra trường error-codes trong phản hồi của Google.
Bug Icon

Score thấp (ví dụ <0.5)

Có thể dẫn đến việc từ chối ngay cả khi success=true, vì Google đánh giá mức độ tin cậy của người dùng dựa trên score.
Bug Icon

Kiểm tra action

Để đảm bảo token được tạo ra cho đúng hành động cụ thể trên trang

Mã lỗi Google siteverify

secretSecret key
missing-input-secret

Thiếu tham số secret

secretSecret key
invalid-input-secret

Tham số secret không hợp lệ hoặc sai định dạng

responseToken
missing-input-response

Thiếu token

responseToken
invalid-input-response

Token không hợp lệ hoặc sai định dạng

requestRequest
bad-request

Yêu cầu không hợp lệ hoặc sai định dạng

responseThời hạn token
timeout-or-duplicate

Token quá cũ hoặc đã được sử dụng

Các captcha khác mà CapMonster Cloud giải được

Câu hỏi thường gặp về reCAPTCHA v3

Tôi nên đặt giá trị minScore nào cho tác vụ reCAPTCHA v3?

Tham số minScore nhận giá trị từ 0.1 đến 0.9 và cho CapMonster Cloud biết điểm trust tối thiểu mà token trả về phải đạt. 0.3 là điểm khởi đầu hợp lý. Giá trị quá cao (ví dụ 0.9) làm tăng khả năng lỗi giải; quá thấp có thể trả về token có điểm mà ngưỡng phía server vẫn sẽ từ chối. Hãy điều chỉnh theo tỷ lệ từ chối thực tế trong môi trường thử nghiệm.

Làm thế nào để tìm sitekey và action cho tác vụ reCAPTCHA v3?

Mở trang và tìm api.js?render=SITE_KEY trong công cụ kiểm tra. Giá trị sau render= là sitekey. action nằm trong lệnh gọi grecaptcha.execute(siteKey, {action: "..."}). Có thể dùng Playwright để tự động ghi nhận lệnh gọi này. Một số giá trị thay đổi sau mỗi lần tải trang, vì vậy hãy tạo tác vụ ngay sau khi thu thập. Xem các bước đầy đủ.

Điểm reCAPTCHA v3 bao nhiêu là tốt?

1.0 cho biết tương tác rất có thể là hợp lệ, còn 0.0 cho biết rất có thể là bot. Google đề xuất ngưỡng mặc định 0.5. Điểm phù hợp phụ thuộc vào ngưỡng của trang đích. Đặt minScore tương ứng và điều chỉnh theo lưu lượng thực tế. Cách kiểm tra điểm.

Token reCAPTCHA v3 có hiệu lực bao lâu sau khi được cấp?

Token nhận từ reCAPTCHA v3 có hiệu lực khoảng 2 phút. Pipeline tự động hóa phải gửi token lên server trong khoảng thời gian đó; sau khi hết hạn, endpoint siteverify của Google trả về success: false. Thực hiện bước giải càng gần lúc gửi form càng tốt và tránh cache token giữa các request.

Mỗi token chỉ được xác minh một lần. Token hết hạn hoặc đã sử dụng sẽ trả về timeout-or-duplicate. Hãy yêu cầu token mới cho mỗi lần gửi.

Làm sao chèn token reCAPTCHA v3 bằng Playwright, Puppeteer hoặc Selenium?

Để chèn token reCAPTCHA v3, tìm trường phản hồi ẩn (thường là textarea hoặc input có ID g-recaptcha-response) và chèn token lấy từ dịch vụ giải CAPTCHA. Cách làm trên ba framework tự động hóa như sau.

Playwright / Puppeteer (Node.js)

javascript
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
  document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');

Selenium (Python)

python
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()

Một số website dùng hàm callback để xác thực token. Nếu form không gửi được, tìm tên hàm qua console (___grecaptcha_cfg.clients) và gọi thủ công:

javascript
await page.evaluate((t) => {
  window.onSuccessCallback(t);
}, token);

Tại sao reCAPTCHA v3 trả về success=true nhưng vẫn từ chối request của tôi?

Phản hồi success: true từ Google chỉ có nghĩa token hợp lệ. Backend vẫn có thể từ chối request nếu điểm token thấp hơn ngưỡng bạn cấu hình.

Vấn đề phổ biến khác là action không khớp. Token phải được xác minh với cùng giá trị action đã dùng khi tạo tác vụ.

Để chẩn đoán:

  • kiểm tra trường score trong phản hồi siteverify;
  • xác nhận giá trị action khớp;
  • xem error-codes khi success là false.

Nếu success là true, mảng error-codes thường rỗng — score và action là các trường chính cần kiểm tra.

CapMonster Cloud có giải reCAPTCHA v3 Enterprise không?

Có. Thêm isEnterprise: true vào tác vụ reCAPTCHA v3 (giá trị hợp lệ: true/false hoặc 1/0). Tác vụ được xử lý giống RecaptchaV3EnterpriseTask. Xem phần bên trên và tài liệu API.

CapMonster Cloud

Không công cụ nào có thể bảo đảm tỷ lệ thành công 100% trước các biện pháp bảo vệ liên tục thay đổi, nhưng CapMonster Cloud cung cấp tỷ lệ thành công cao khi giải reCAPTCHA v3. Dữ liệu dựa trên các bài kiểm tra nội bộ hằng tháng của nhóm CapMonster Cloud. Thời gian phản hồi API và tỷ lệ thành công thực tế thay đổi tùy theo trang đích, tải máy chủ và điều kiện mạng.

reCAPTCHA là nhãn hiệu của Google LLC. CapMonster Cloud không liên kết với Google và không được Google chứng thực. Dịch vụ dành cho dữ liệu công khai, kiểm thử các trang thuộc sở hữu của bạn hoặc được phép kiểm thử, nhận dạng hình ảnh và hỗ trợ khả năng tiếp cận. Việc thu thập dữ liệu của bên thứ ba được bảo vệ bằng đăng nhập hoặc trả phí khi chưa được phép là bị cấm; tài khoản của chính bạn không bị ảnh hưởng. Bạn xác định tình trạng pháp lý của dữ liệu trước khi bắt đầu.