# YesCaptcha Docs

> YesCaptcha là API nhận dạng captcha. Dùng một API JSON để giải reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF và captcha hình ảnh, trừ điểm theo từng tác vụ; tác vụ thất bại hoặc quá thời gian sẽ tự động hoàn điểm.

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

- Home: https://docs.yescaptcha.com/vi/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/vi/llms-full.txt

## Bắt đầu

- [Giới thiệu](https://docs.yescaptcha.com/vi/getting-started/introduction.md): YesCaptcha là gì. Giải reCAPTCHA, hCaptcha, Turnstile, FunCaptcha và captcha hình ảnh qua API hoặc tiện ích trình duyệt, trừ điểm theo từng tác vụ, tác vụ thất bại được hoàn điểm tự động.
- [Bắt đầu nhanh](https://docs.yescaptcha.com/vi/getting-started/quickstart.md): Gửi yêu cầu YesCaptcha đầu tiên trong 5 phút: đăng ký, sao chép clientKey, nạp tiền, rồi nhận dạng một ảnh captcha bằng curl, Python hoặc Node.js (ImageToTextTaskOcrBase, trả kết quả đồng bộ, 2 điểm mỗi lần).
- [Địa chỉ truy cập](https://docs.yescaptcha.com/vi/getting-started/endpoints.md): Hai endpoint của YesCaptcha API: endpoint quốc tế api.yescaptcha.com và endpoint Trung Quốc cn.yescaptcha.com; chỉ nhận HTTPS POST với JSON, tạo và truy vấn tác vụ trên cùng một endpoint.
- [Tính phí và hoàn điểm](https://docs.yescaptcha.com/vi/getting-started/billing.md): Cách YesCaptcha trừ điểm: 1,000 điểm = ¥1, trừ theo loại tác vụ; nhận dạng thất bại và hết thời gian chờ được tự động hoàn điểm, yêu cầu trả về lỗi không bị trừ điểm; số dư phải lớn hơn 10 điểm; báo cáo nhận dạng hình ảnh thất bại sẽ được hoàn điểm sau khoảng 24 giờ.

## Tham chiếu API

- [Yêu cầu và phản hồi](https://docs.yescaptcha.com/vi/api/overview.md): Quy ước chung của YesCaptcha API: POST JSON, xác thực bằng clientKey, định dạng phản hồi errorId, tác vụ đồng bộ và bất đồng bộ, polling mỗi 5 giây, timeout 110 giây, kết quả được lưu khoảng 10 phút, ngôn ngữ thông báo theo Accept-Language.
- [createTask – Tạo tác vụ](https://docs.yescaptcha.com/vi/api/create-task.md): POST /createTask tạo một tác vụ nhận dạng captcha. Các tham số yêu cầu (clientKey, task, softID), thứ tự kiểm tra, loại bất đồng bộ trả về taskId, loại đồng bộ trả về solution trực tiếp; số dư phải lớn hơn 10 điểm.
- [getTaskResult – Lấy kết quả](https://docs.yescaptcha.com/vi/api/get-task-result.md): POST /getTaskResult truy vấn kết quả của tác vụ bất đồng bộ. Gọi lại mỗi 5 giây, tiếp tục chờ khi processing, đọc solution khi ready, dừng khi có lỗi; tác vụ chạy tối đa khoảng 110 giây, kết quả được giữ khoảng 10 phút, truy vấn không trừ điểm.
- [getBalance - Truy vấn số dư](https://docs.yescaptcha.com/vi/api/get-balance.md): POST /getBalance truy vấn số dư tài khoản (điểm, 1,000 điểm = ¥1) cùng số dư chia sẻ doanh thu cho nhà phát triển và thưởng giới thiệu. Không trừ điểm, có thể dùng để kiểm tra clientKey.
- [getSoftID – Truy vấn ID nhà phát triển](https://docs.yescaptcha.com/vi/api/get-soft-id.md): POST /getSoftID trả về ID nhà phát triển (softID) và tổng số tiền chia sẻ doanh thu đã tích lũy của bạn; đặt softID vào yêu cầu createTask khi người khác dùng phần mềm của bạn để nhận phần chia sẻ.
- [report – Báo cáo kết quả](https://docs.yescaptcha.com/vi/api/report.md): POST /report báo cho YesCaptcha biết kết quả của tác vụ đúng hay sai; hãy báo cáo trung thực cả thành công lẫn thất bại. Với loại nhận dạng hình ảnh, báo cáo thất bại trong vòng 1 giờ sau khi tạo tác vụ sẽ được quyết toán hoàn điểm sau khoảng 24 giờ.
- [useragent - Lấy User-Agent](https://docs.yescaptcha.com/vi/api/useragent.md): GET https://api.yescaptcha.com/useragent trả về User-Agent trình duyệt nên dùng (văn bản thuần). Trường userAgent của tác vụ hCaptcha chỉ chấp nhận giá trị này.
- [Mã lỗi](https://docs.yescaptcha.com/vi/api/errors.md): Ý nghĩa và cách xử lý tất cả mã lỗi của YesCaptcha API, chia theo nhóm: định dạng yêu cầu, tài khoản và số dư, giới hạn đồng thời và tạm dừng, kết quả tác vụ, tham số trang web, hình ảnh, proxy, phía máy chủ. Yêu cầu trả về lỗi không bị trừ điểm.
- [Giới hạn đồng thời và tự động tạm dừng](https://docs.yescaptcha.com/vi/api/rate-limits.md): Giới hạn đồng thời của YesCaptcha (ERROR_THREADS_MAXIMUM, không trừ điểm, không tính vào tự động tạm dừng), tự động tạm dừng khi có quá nhiều lỗi (100 lần trong một phút thì tạm dừng 5 phút, ERROR_IP_BLOCKED_5MIN) và bộ nhớ đệm tham số không hợp lệ (cached).

## Loại tác vụ

- [Loại tác vụ và bảng giá](https://docs.yescaptcha.com/vi/tasks.md): Giá (điểm, 1 tệ = 1,000 điểm) và cách trả kết quả của tất cả loại tác vụ công khai của YesCaptcha: token cho reCAPTCHA, hCaptcha, Turnstile, Cookie cho trang thử thách Cloudflare, kết quả nhận dạng cho captcha ảnh chữ-số và nhận dạng hình ảnh.
- [reCAPTCHA v2](https://docs.yescaptcha.com/vi/tasks/recaptcha-v2.md): Lấy token reCAPTCHA v2 (bản thường, bản ẩn, bản Enterprise) với YesCaptcha: loại tác vụ và giá, tham số yêu cầu, ví dụ curl/Python/Node.js và kết quả trả về.
- [reCAPTCHA v3](https://docs.yescaptcha.com/vi/tasks/recaptcha-v3.md): Lấy token reCAPTCHA v3 (gồm cả bản Enterprise) bằng YesCaptcha: cách điền pageAction, các loại có điểm cố định 0.7 và 0.9, loại tác vụ và giá, tham số, ví dụ và kết quả trả về.
- [hCaptcha](https://docs.yescaptcha.com/vi/tasks/hcaptcha.md): Lấy token hCaptcha bằng YesCaptcha: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 và HCaptchaTask dùng proxy riêng, cách điền userAgent, rqdata và cách dùng respKey trả về.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/vi/tasks/turnstile.md): Lấy token Cloudflare Turnstile bằng YesCaptcha: TurnstileTaskProxyless, TurnstileTaskProxylessM1 và TurnstileTask dùng proxy của bạn, tham số, ví dụ và kết quả trả về; khác biệt với trang thử thách Cloudflare.
- [Trang thử thách Cloudflare (5 giây)](https://docs.yescaptcha.com/vi/tasks/cloudflare-challenge.md): Dùng YesCaptcha vượt qua trang kiểm tra "Just a moment..." của Cloudflare (trang thử thách 5 giây) để nhận cookie như cf_clearance, User-Agent và nội dung trang: tham số của CloudFlareTaskS2 và CloudFlareTaskS3, yêu cầu về proxy, kết quả trả về, cách dùng kết quả và các lỗi thường gặp.
- [Nhận dạng chữ và số trong ảnh](https://docs.yescaptcha.com/vi/tasks/image-to-text.md): Dùng YesCaptcha để đọc chữ cái và chữ số trong ảnh: ImageToTextTaskOcrBase và ImageToTextTaskMuggle trả kết quả đồng bộ; ImageToTextTask và ImageToTextTaskM1 bất đồng bộ, hỗ trợ phân biệt hoa/thường, chỉ chữ số, phép tính; có thể định chế mô hình riêng.
- [Nhận dạng hình ảnh reCAPTCHA v2](https://docs.yescaptcha.com/vi/tasks/recaptcha-classification.md): Dùng YesCaptcha để nhận dạng câu hỏi hình ảnh của reCAPTCHA v2 (ReCaptchaV2Classification): tải lên ảnh 3x3, 4x4 hoặc 1x1 cùng ID câu hỏi, nhận về ngay (đồng bộ) các ô cần nhấp; tính phí theo kích thước ảnh, kèm bảng ID câu hỏi.
- [Nhận dạng hình ảnh hCaptcha](https://docs.yescaptcha.com/vi/tasks/hcaptcha-classification.md): Dùng YesCaptcha để nhận dạng câu hỏi hình ảnh của hCaptcha (HCaptchaClassification): chọn trong lưới 3×3, nhấp vào vị trí chỉ định, kéo đến vị trí chỉ định, câu hỏi động; trả kết quả đồng bộ, không trừ điểm khi không nhận ra mục tiêu.
- [Nhận dạng hình ảnh FunCaptcha](https://docs.yescaptcha.com/vi/tasks/funcaptcha-classification.md): Dùng YesCaptcha để nhận dạng câu đố hình ảnh của FunCaptcha (Arkose Labs) (FunCaptchaClassification): tải lên ảnh câu đố (lưới 6 ô hoặc ảnh mũi tên ghép trái-phải) cùng câu hỏi tiếng Anh, nhận ngay kết quả đồng bộ là nên chọn ảnh thứ mấy; hỗ trợ mọi dạng câu đố.
- [Nhận dạng hình ảnh AWS WAF / bCaptcha](https://docs.yescaptcha.com/vi/tasks/aws-bcaptcha-classification.md): Dùng YesCaptcha để nhận dạng câu hỏi hình ảnh lưới 3×3 của AWS WAF CAPTCHA và bCaptcha (AwsClassification, bCaptchaClassification): tải lên toàn bộ ảnh và câu hỏi, nhận về đồng bộ các ô cần nhấp.

## Tiện ích trình duyệt

- [YesCaptcha Assistant - tiện ích trình duyệt](https://docs.yescaptcha.com/vi/extension.md): YesCaptcha Assistant (tiện ích trình duyệt) tự động nhận dạng và nhấp captcha reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF, v.v. trên Chrome và Firefox. Tiện ích miễn phí, chỉ trừ điểm theo các API dùng để nhận dạng. Có liên kết cửa hàng, gói cài đặt và video hướng dẫn cài trên Chrome, BitBrowser, Kiwi Browser.

## Hướng dẫn

- [Nhận biết loại captcha](https://docs.yescaptcha.com/vi/guides/identify-captcha.md): Cách nhận biết trang web dùng loại captcha nào: reCAPTCHA v2, v2 ẩn, v3, bản Enterprise, hCaptcha, sự khác nhau giữa Cloudflare Turnstile và trang thử thách Cloudflare, cùng loại tác vụ YesCaptcha tương ứng.
- [Tìm tham số reCAPTCHA](https://docs.yescaptcha.com/vi/guides/find-recaptcha-parameters.md): Cách tìm websiteKey (sitekey), websiteURL, pageAction của v3 và hàm callback của reCAPTCHA trong các tab Network, Sources và Console của công cụ dành cho nhà phát triển, kèm script tự động tìm.
- [Tìm tham số hCaptcha](https://docs.yescaptcha.com/vi/guides/find-hcaptcha-parameters.md): Cách tìm websiteKey (sitekey), websiteURL và rqdata của bản Enterprise: tìm data-sitekey trong mã nguồn trang, hoặc tìm các request checksiteconfig, getcaptcha trong Network.
- [Tìm tham số Turnstile](https://docs.yescaptcha.com/vi/guides/find-turnstile-parameters.md): Cách tìm websiteKey (sitekey, bắt đầu bằng 0x) và websiteURL của Cloudflare Turnstile: tìm data-sitekey hoặc turnstile.render trong mã nguồn trang, hoặc xem các request tới challenges.cloudflare.com trong Network.
- [Dùng token để vượt reCAPTCHA](https://docs.yescaptcha.com/vi/guides/submit-recaptcha-token.md): Cách dùng token reCAPTCHA (gRecaptchaResponse) sau khi nhận được: nguyên lý, gửi trực tiếp bằng request HTTP (trường g-recaptcha-response), hoặc điền vào trình duyệt rồi gọi hàm callback, kèm ví dụ Python hoàn chỉnh trên trang demo của Google.
- [Mô phỏng click nhận dạng hình ảnh reCAPTCHA v2 (Selenium)](https://docs.yescaptcha.com/vi/guides/recaptcha-click-selenium.md): Dùng Python Selenium 4 và ReCaptchaV2Classification để tự động click các ô ảnh của reCAPTCHA v2 trong trình duyệt: kích hoạt captcha, đọc câu hỏi và hình ảnh, gọi API nhận dạng, click các ô, gửi biểu mẫu; kèm mã ví dụ đầy đủ.
- [Mô phỏng click hình ảnh hCaptcha bằng Selenium](https://docs.yescaptcha.com/vi/guides/hcaptcha-click-selenium.md): Dùng Python, Selenium 4 và HCaptchaClassification để tự động hoàn thành câu đố hình ảnh lưới 3×3 của hCaptcha trong trình duyệt thật: nhấp vào hộp kiểm, đọc câu hỏi và 9 hình ảnh, gọi API nhận dạng, click và gửi; kèm mã ví dụ đầy đủ.

## Mã mẫu

- [Mã mẫu và SDK](https://docs.yescaptcha.com/vi/samples.md): Mã mẫu có thể chạy ngay của YesCaptcha (Python, Node.js, curl, C#, Easy Language) và các SDK không chính thức do cộng đồng đóng góp (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/vi/samples/python.md): Ví dụ Python cho YesCaptcha: truy vấn số dư, nhận dạng captcha hình ảnh, lớp client dùng lại được (tạo tác vụ, polling mỗi 5 giây), kiểm soát đồng thời bằng asyncio, và gửi reCAPTCHA bằng requests và Selenium.
- [Node.js](https://docs.yescaptcha.com/vi/samples/nodejs.md): Ví dụ Node.js cho YesCaptcha (Node.js 18+, dùng `fetch` có sẵn, không cần thư viện bên thứ ba): truy vấn số dư, nhận dạng captcha hình ảnh và một lớp client có thể tái sử dụng (tạo tác vụ, polling mỗi 5 giây).
- [C#](https://docs.yescaptcha.com/vi/samples/csharp.md): Ví dụ C# của YesCaptcha (.NET 6+, HttpClient + System.Text.Json): truy vấn số dư, tạo tác vụ reCAPTCHA v2 và polling kết quả mỗi 5 giây.
- [Easy Language (易语言)](https://docs.yescaptcha.com/vi/samples/easy-language.md): Ví dụ YesCaptcha bằng Easy Language (易语言) do người dùng đóng góp: nhấp chuột mô phỏng cho reCAPTCHA và hCaptcha, nhận dạng hình ảnh FunCaptcha, gửi token reCAPTCHA; gói tải về và những điểm chính khi gọi API.

## Tài khoản

- [Nhiều clientKey: hạn mức, IP cho phép và thời gian hết hạn](https://docs.yescaptcha.com/vi/account/client-keys.md): Một tài khoản YesCaptcha có tối đa 20 clientKey, cùng trừ vào một số dư tài khoản. Mỗi clientKey có thể đặt riêng hạn mức chi tiêu (theo ngày, tuần, tháng hoặc tổng một lần, đặt lại theo giờ Bắc Kinh), IP cho phép và thời gian hết hạn, có hiệu lực trong vài giây.
- [Nạp tiền và VIP](https://docs.yescaptcha.com/vi/account/recharge.md): Cách nạp tiền vào YesCaptcha (WeChat Pay, Alipay, PayPal, tiền mã hóa), 1,000 điểm = ¥1. Tổng số tiền đã nạp tự động nâng cấp bạn từ VIP 1 lên VIP 10, và mỗi lần nạp sau đó được tặng thêm điểm theo tỷ lệ.
- [Thưởng giới thiệu](https://docs.yescaptcha.com/vi/account/referral.md): Chương trình giới thiệu của YesCaptcha. Người được mời nhận VIP ngay khi đăng ký (cấp của bạn trừ 1, từ VIP 1 đến VIP 6), bạn nhận 20% số tiền họ chi tiêu (khi có chia sẻ doanh thu cho nhà phát triển thì mỗi bên 10%), có thể chuyển thành số dư hoặc rút khi đạt 100 ¥ trong bảng điều khiển.
- [Chia sẻ doanh thu cho nhà phát triển](https://docs.yescaptcha.com/vi/account/developer.md): Chia sẻ doanh thu cho nhà phát triển của YesCaptcha: đưa softID của bạn vào các yêu cầu mà phần mềm hoặc tiện ích bạn phát triển gửi đi cho người dùng, bạn nhận 20% số tiền họ chi tiêu (10% mỗi bên khi người dùng còn có người giới thiệu); có thể chuyển thành số dư hoặc rút khi đủ 100 ¥ trong bảng điều khiển.

## Trợ giúp

- [Câu hỏi thường gặp](https://docs.yescaptcha.com/vi/help/faq.md): Câu hỏi thường gặp về YesCaptcha: nhận dạng thất bại có bị trừ điểm không, token có hiệu lực bao lâu, tỷ lệ vượt qua, người hay máy nhận dạng, có bị khóa tài khoản không, dùng một clientKey ở nhiều nơi, chọn endpoint nào, khác biệt giữa tiện ích và API.
- [Sự cố kết nối và mạng](https://docs.yescaptcha.com/vi/help/troubleshooting.md): Cách xử lý khi không kết nối được API YesCaptcha. Các bước kiểm tra lỗi Failed to establish a new connection, lỗi phân giải DNS, phần mềm proxy gây nhiễu và lỗi chứng chỉ SSL (Certificate has expired, SSLEOFError).
- [Liên hệ chúng tôi](https://docs.yescaptcha.com/vi/help/contact.md): Liên hệ bộ phận hỗ trợ YesCaptcha qua WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official hoặc email yescaptcha@gmail.com, 9:00–21:00 UTC+8.
- [Nhật ký cập nhật dịch vụ](https://docs.yescaptcha.com/vi/changelog.md): Những thay đổi ảnh hưởng đến người dùng YesCaptcha, ghi theo ngày: loại tác vụ mới và đã ngừng, quy tắc tính phí và hoàn điểm, giới hạn đồng thời, việc chuyển tài liệu. Bắt đầu ghi từ 2026-10.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/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)
- [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)