# YesCaptcha Docs

> YesCaptcha는 캡차 인식 API예요. JSON 인터페이스 하나로 reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF, 이미지 캡차를 인식하고, 작업별로 포인트를 차감해요. 인식에 실패하거나 시간이 초과되면 포인트가 자동으로 환불돼요.

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

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

## 시작하기

- [소개](https://docs.yescaptcha.com/ko/getting-started/introduction.md): YesCaptcha가 무엇인지 설명해요. API나 브라우저 확장 프로그램으로 reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, 이미지 캡차를 인식하고, 작업마다 포인트를 차감하며, 실패한 작업은 자동으로 포인트를 환불해요.
- [빠른 시작](https://docs.yescaptcha.com/ko/getting-started/quickstart.md): 5분 만에 첫 YesCaptcha 요청을 보내요. 회원가입, clientKey 복사, 충전을 마친 뒤 curl, Python, Node.js로 이미지 캡차를 인식해요(ImageToTextTaskOcrBase, 동기 반환, 건당 2포인트).
- [엔드포인트](https://docs.yescaptcha.com/ko/getting-started/endpoints.md): YesCaptcha API의 두 엔드포인트인 글로벌 엔드포인트 api.yescaptcha.com과 중국 엔드포인트 cn.yescaptcha.com이에요. HTTPS POST JSON만 받으며, 작업 생성과 조회는 같은 엔드포인트에서 해야 해요.
- [과금과 포인트 환불](https://docs.yescaptcha.com/ko/getting-started/billing.md): YesCaptcha의 포인트 차감 방식이에요. 1위안 = 1,000포인트이고 작업 유형별로 차감해요. 인식 실패와 타임아웃은 자동으로 포인트가 환불되고, 오류를 반환한 요청은 차감하지 않아요. 잔액은 10포인트보다 많아야 해요. 이미지 인식 신고 후 포인트 환불은 약 24시간 뒤에 처리돼요.

## API 레퍼런스

- [요청과 응답](https://docs.yescaptcha.com/ko/api/overview.md): YesCaptcha API의 공통 규칙: POST JSON, clientKey 인증, errorId 응답 형식, 동기·비동기 작업, 5초마다 폴링, 110초 타임아웃, 결과 약 10분 보관, Accept-Language에 따른 안내 문구 언어.
- [createTask 작업 생성](https://docs.yescaptcha.com/ko/api/create-task.md): POST /createTask로 캡차 인식 작업을 생성해요. 요청 파라미터(clientKey, task, softID), 검증 순서, 비동기 유형은 taskId 반환, 동기 유형은 solution 직접 반환, 잔액은 10 포인트보다 많아야 해요.
- [getTaskResult 결과 조회](https://docs.yescaptcha.com/ko/api/get-task-result.md): POST /getTaskResult로 비동기 작업의 결과를 조회해요. 5초마다 조회하고, processing이면 계속 기다리고, ready이면 solution을 가져오고, 오류가 나면 폴링을 멈추세요. 작업은 최대 약 110초 걸리고, 결과는 약 10분 동안 보관되며, 조회는 포인트를 차감하지 않아요.
- [getBalance 잔액 조회](https://docs.yescaptcha.com/ko/api/get-balance.md): POST /getBalance로 계정 잔액(포인트, 1,000포인트 = ¥1)과 개발자 수익 배분·추천 보상 잔액을 조회해요. 포인트가 차감되지 않아 clientKey를 확인하는 데 쓸 수 있어요.
- [getSoftID 개발자 ID 조회](https://docs.yescaptcha.com/ko/api/get-soft-id.md): POST /getSoftID로 개발자 ID(softID)와 누적 개발자 수익 배분 금액을 조회해요. 다른 사용자가 내 소프트웨어를 쓸 때 보내는 createTask 요청에 softID를 넣으면 수익을 배분받을 수 있어요.
- [report 결과 신고](https://docs.yescaptcha.com/ko/api/report.md): POST /report로 작업의 인식 결과가 맞았는지 신고해요. 성공과 실패 모두 사실대로 신고해 주세요. 이미지 인식 유형은 작업 생성 후 1시간 이내에 실패를 신고하면 약 24시간 뒤에 포인트 환불이 정산돼요.
- [useragent로 UA 가져오기](https://docs.yescaptcha.com/ko/api/useragent.md): GET https://api.yescaptcha.com/useragent는 현재 권장하는 브라우저 User-Agent를 일반 텍스트로 반환해요. hCaptcha 작업의 userAgent는 이 값만 허용해요.
- [오류 코드](https://docs.yescaptcha.com/ko/api/errors.md): YesCaptcha API의 모든 오류 코드의 의미와 처리 방법을 요청 형식, 계정 잔액, 동시 작업과 일시 중지, 작업 결과, 사이트 파라미터, 이미지, 프록시, 서버별로 정리했어요. 오류를 반환한 요청은 포인트를 차감하지 않아요.
- [동시 작업 수 제한과 자동 일시 중지](https://docs.yescaptcha.com/ko/api/rate-limits.md): YesCaptcha의 동시 작업 수 제한(ERROR_THREADS_MAXIMUM, 포인트 차감 없음, 일시 중지에 포함되지 않음), 오류가 너무 많을 때의 자동 일시 중지(1분에 100회 발생하면 5분간 일시 중지, ERROR_IP_BLOCKED_5MIN), 잘못된 파라미터 캐시(cached)를 설명해요.

## 작업 유형

- [작업 유형과 가격](https://docs.yescaptcha.com/ko/tasks.md): YesCaptcha의 모든 공개 작업 유형의 가격(포인트, 1,000포인트 = ¥1)과 반환 방식을 안내해요. reCAPTCHA, hCaptcha, Turnstile은 토큰을, Cloudflare 챌린지 페이지는 Cookie를, 이미지 영문·숫자 인식과 이미지 인식은 인식 결과를 반환해요.
- [reCAPTCHA v2](https://docs.yescaptcha.com/ko/tasks/recaptcha-v2.md): YesCaptcha로 reCAPTCHA v2(일반, 인비저블, Enterprise)의 토큰을 받아요. 작업 유형과 가격, 요청 파라미터, curl/Python/Node.js 예제와 반환 결과를 안내해요.
- [reCAPTCHA v3](https://docs.yescaptcha.com/ko/tasks/recaptcha-v3.md): YesCaptcha로 reCAPTCHA v3(엔터프라이즈 포함) 토큰을 받는 방법이에요. pageAction 입력 방법, 고정 점수 0.7·0.9 유형, 작업 유형과 가격, 파라미터, 예시, 반환 결과를 설명해요.
- [hCaptcha](https://docs.yescaptcha.com/ko/tasks/hcaptcha.md): YesCaptcha로 hCaptcha 토큰을 받는 방법이에요. HCaptchaTaskProxyless, HCaptchaTaskProxylessM1, 자체 프록시를 쓰는 HCaptchaTask, userAgent와 rqdata 입력 방법, 반환된 respKey 사용법을 설명해요.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/ko/tasks/turnstile.md): YesCaptcha로 Cloudflare Turnstile 토큰을 받아요. TurnstileTaskProxyless, TurnstileTaskProxylessM1, 자체 프록시를 쓰는 TurnstileTask의 파라미터, 예제, 반환 결과와 Cloudflare 챌린지 페이지와의 차이를 설명해요.
- [Cloudflare 챌린지 페이지](https://docs.yescaptcha.com/ko/tasks/cloudflare-challenge.md): YesCaptcha로 Cloudflare의 "잠시만 기다리세요" 확인 페이지(Cloudflare 챌린지 페이지)를 통과하고 cf_clearance 등 쿠키, User-Agent, 웹페이지 내용을 받아요. CloudFlareTaskS2와 CloudFlareTaskS3의 파라미터, 프록시 요구 사항, 반환 결과, 결과 사용 방법, 자주 발생하는 오류를 설명해요.
- [이미지 영문·숫자 인식](https://docs.yescaptcha.com/ko/tasks/image-to-text.md): YesCaptcha로 이미지 속 영문과 숫자를 인식해요. ImageToTextTaskOcrBase와 ImageToTextTaskMuggle은 동기로 결과를 반환하고, ImageToTextTask와 ImageToTextTaskM1은 비동기이며 대소문자, 숫자만, 수식 등의 조건을 지원해요. 모델 맞춤 제작도 가능해요.
- [reCAPTCHA v2 이미지 인식](https://docs.yescaptcha.com/ko/tasks/recaptcha-classification.md): YesCaptcha로 reCAPTCHA v2 이미지 문제(ReCaptchaV2Classification)를 인식해요. 3x3, 4x4, 1x1 이미지와 질문 ID를 보내면 클릭할 칸을 동기로 반환해요. 이미지 크기별로 과금하며, 질문 ID 표를 제공해요.
- [hCaptcha 이미지 인식](https://docs.yescaptcha.com/ko/tasks/hcaptcha-classification.md): YesCaptcha로 hCaptcha 이미지 문제(HCaptchaClassification)를 인식해요. 3×3 그리드 선택, 지정 위치 클릭, 지정 위치로 드래그, 애니메이션 문제를 지원하고, 동기로 결과를 반환하며, 대상을 찾지 못하면 포인트가 차감되지 않아요.
- [FunCaptcha 이미지 인식](https://docs.yescaptcha.com/ko/tasks/funcaptcha-classification.md): YesCaptcha로 FunCaptcha(Arkose Labs)의 이미지 문제(FunCaptchaClassification)를 인식해요. 문제 이미지(6칸 그리드 또는 좌우로 합쳐진 화살표 문제)와 영어 질문을 업로드하면 몇 번째 이미지를 선택해야 하는지 동기로 반환해요. 모든 문제 유형을 지원해요.
- [AWS WAF / bCaptcha 이미지 인식](https://docs.yescaptcha.com/ko/tasks/aws-bcaptcha-classification.md): YesCaptcha로 AWS WAF CAPTCHA와 bCaptcha의 3×3 그리드 이미지 문제를 인식해요 (AwsClassification, bCaptchaClassification). 전체 이미지와 질문을 보내면 클릭할 칸을 동기로 반환해요.

## 브라우저 확장 프로그램

- [YesCaptcha Assistant](https://docs.yescaptcha.com/ko/extension.md): YesCaptcha Assistant(브라우저 확장 프로그램)는 Chrome과 Firefox에서 reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF 같은 캡차를 자동으로 인식하고 클릭해요. 확장 프로그램은 무료이고, 인식에 사용한 API 기준으로 포인트가 차감돼요. 스토어 링크, 설치 파일 다운로드, Chrome·BitBrowser·Kiwi Browser 설치 영상을 안내해요.

## 가이드

- [캡차 유형 판별하기](https://docs.yescaptcha.com/ko/guides/identify-captcha.md): 웹 페이지의 캡차가 어떤 종류인지 판별하는 방법과 reCAPTCHA v2, v2 인비저블, v3, Enterprise, hCaptcha, Cloudflare Turnstile, Cloudflare 챌린지 페이지의 차이, 그리고 각각에 맞는 YesCaptcha 작업 유형을 안내해요.
- [reCAPTCHA 파라미터 찾기](https://docs.yescaptcha.com/ko/guides/find-recaptcha-parameters.md): reCAPTCHA의 websiteKey(sitekey), websiteURL, v3의 pageAction, 콜백 함수를 개발자 도구의 Network, Sources, Console에서 찾는 방법과 자동 조회 스크립트를 안내해요.
- [hCaptcha 파라미터 찾기](https://docs.yescaptcha.com/ko/guides/find-hcaptcha-parameters.md): hCaptcha의 websiteKey(sitekey), websiteURL, 엔터프라이즈 버전의 rqdata를 찾는 방법이에요. 웹 페이지 소스에서 data-sitekey를 검색하거나 Network에서 checksiteconfig, getcaptcha 요청을 찾아보세요.
- [Turnstile 파라미터 찾기](https://docs.yescaptcha.com/ko/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/ko/guides/submit-recaptcha-token.md): reCAPTCHA의 token(gRecaptchaResponse)을 받은 뒤 사용하는 방법을 설명해요. 동작 원리, 직접 요청으로 제출하기(g-recaptcha-response 필드), 브라우저에 입력하고 콜백 함수 호출하기, 그리고 Google 데모 페이지의 전체 Python 예제를 담았어요.
- [reCAPTCHA v2 이미지 인식 클릭 시뮬레이션(Selenium)](https://docs.yescaptcha.com/ko/guides/recaptcha-click-selenium.md): Python Selenium 4와 ReCaptchaV2Classification으로 브라우저에서 reCAPTCHA v2 이미지 문제를 자동으로 클릭해요. 캡차 실행, 질문과 이미지 읽기, 인식 API 호출, 칸 클릭, 제출까지 전체 예제 코드를 제공해요.
- [hCaptcha 이미지 인식 클릭 시뮬레이션(Selenium)](https://docs.yescaptcha.com/ko/guides/hcaptcha-click-selenium.md): Python Selenium 4와 HCaptchaClassification으로 브라우저에서 hCaptcha의 3×3 그리드 이미지 문제를 자동으로 풀어요. 체크박스 클릭, 질문과 이미지 9장 읽기, 인식 API 호출, 클릭, 제출까지 전체 예제 코드를 제공해요.

## 샘플 코드

- [예제 코드와 SDK](https://docs.yescaptcha.com/ko/samples.md): YesCaptcha의 바로 실행할 수 있는 예제 코드(Python, Node.js, curl, C#, 이지 랭귀지)와 사용자가 제공한 비공식 SDK(Python, Node.js, Go)예요.
- [Python](https://docs.yescaptcha.com/ko/samples/python.md): YesCaptcha의 Python 예제예요. 잔액 조회, 이미지 캡차 인식, 재사용 가능한 클라이언트 클래스(작업 생성, 5초마다 폴링), asyncio 동시 작업 수 제어, requests와 Selenium으로 reCAPTCHA 제출까지 다뤄요.
- [Node.js](https://docs.yescaptcha.com/ko/samples/nodejs.md): YesCaptcha의 Node.js 예제(Node.js 18 이상, 내장 fetch 사용, 서드파티 라이브러리 불필요): 잔액 조회, 이미지 캡차 인식, 재사용 가능한 클라이언트 클래스(작업 생성, 5초마다 폴링).
- [C#](https://docs.yescaptcha.com/ko/samples/csharp.md): YesCaptcha의 C# 예제(.NET 6+, HttpClient + System.Text.Json)예요. 잔액을 조회하고, reCAPTCHA v2 작업을 만든 뒤 5초마다 결과를 폴링해요.
- [이지 랭귀지(易语言)](https://docs.yescaptcha.com/ko/samples/easy-language.md): 사용자가 제공한 YesCaptcha 이지 랭귀지(易语言) 예제예요. reCAPTCHA·hCaptcha 클릭 시뮬레이션, FunCaptcha 이미지 인식, reCAPTCHA 토큰 제출과 다운로드 패키지, API 호출 요령을 안내해요.

## 계정

- [여러 clientKey: 한도, IP 허용 목록, 만료 시각](https://docs.yescaptcha.com/ko/account/client-keys.md): YesCaptcha 계정 하나에 clientKey를 최대 20개 만들 수 있고, 모두 같은 계정 잔액에서 포인트가 차감돼요. 각 clientKey마다 사용 한도(매일, 매주, 매월 또는 1회성, 베이징 시간 기준으로 초기화), IP 허용 목록, 만료 시각을 따로 설정할 수 있고, 몇 초 안에 적용돼요.
- [충전과 VIP](https://docs.yescaptcha.com/ko/account/recharge.md): YesCaptcha 충전 방법(WeChat Pay, Alipay, PayPal, 암호화폐)과 1,000포인트 = ¥1 기준을 안내해요. 누적 충전 금액에 따라 VIP 1부터 VIP 10까지 자동으로 올라가고, 이후 충전할 때마다 비율에 따라 보너스 포인트를 받아요.
- [추천 보상](https://docs.yescaptcha.com/ko/account/referral.md): YesCaptcha 추천 보상: 추천받은 사용자는 가입하면 바로 VIP 등급을 받고(내 등급 −1, VIP 1~VIP 6), 나는 상대방 사용 금액의 20%를 받아요(개발자 수익 배분이 함께 있으면 각각 절반씩). 보상은 잔액으로 전환하거나 ¥100 이상일 때 대시보드에서 출금을 신청할 수 있어요.
- [개발자 수익 배분](https://docs.yescaptcha.com/ko/account/developer.md): YesCaptcha 개발자 수익 배분: 직접 개발한 소프트웨어나 확장 프로그램이 사용자의 요청에 softID를 포함하면 사용자 소비 금액의 20%를 받아요(추천인도 있으면 각각 10%). 대시보드에서 잔액으로 전환하거나 100위안부터 출금을 신청할 수 있어요.

## 도움말

- [자주 묻는 질문](https://docs.yescaptcha.com/ko/help/faq.md): YesCaptcha 자주 묻는 질문. 인식에 실패하면 포인트가 차감되는지, 토큰 유효 시간, 통과율, 사람이 인식하는지 기계가 인식하는지, 계정 차단 여부, 하나의 clientKey를 여러 곳에서 사용하는 방법, 엔드포인트 선택, 확장 프로그램과 API의 차이.
- [연결 및 네트워크 문제](https://docs.yescaptcha.com/ko/help/troubleshooting.md): YesCaptcha API에 연결되지 않을 때 대처법. Failed to establish a new connection, DNS 확인 실패, 프록시 소프트웨어 간섭, SSL 인증서 오류(Certificate has expired, SSLEOFError)의 점검 절차를 안내해요.
- [문의하기](https://docs.yescaptcha.com/ko/help/contact.md): YesCaptcha 고객 지원 문의: WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official, 이메일 yescaptcha@gmail.com, 운영 시간 UTC+8 9:00–21:00.
- [서비스 업데이트 기록](https://docs.yescaptcha.com/ko/changelog.md): YesCaptcha에서 사용자에게 영향을 주는 변경 사항을 날짜별로 기록해요. 새로 오픈하거나 중단한 작업 유형, 과금 및 포인트 환불 규칙, 동시 작업 수 제한, 문서 이전을 담고 있어요. 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/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/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)