reCAPTCHA v2 이미지 인식

ReCaptchaV2Classification은 reCAPTCHA v2가 띄우는 이미지 문제를 인식해요. 이미지와 질문 ID를 보내면 클릭해야 할 칸을 반환하고, 브라우저에서 클릭하는 건 여러분의 프로그램이 해요. 토큰은 반환하지 않아요. 동기 방식이라 createTask 요청 한 번으로 결과를 받아요. 3x3, 4x4 이미지는 장당 6 포인트 (≈ $0.90 / 1k)이고, 1x1 작은 이미지는 더 저렴해요. 아래 표를 참고하세요.

팁

클릭 로직을 직접 작성하고 싶지 않다면 브라우저 확장 프로그램을 사용하세요. 이 API를 기반으로 자동으로 클릭해요.

POSThttps://api.yescaptcha.com/createTask글로벌 엔드포인트복사

POSThttps://cn.yescaptcha.com/createTask중국 엔드포인트복사

유형과 가격

작업 유형	가격	반환 방식	설명
ReCaptchaV2Classification	$0.90 / 1k; 6 포인트/작업 · ¥6 / 1k	동기	1x1 타일(100x100)은 2포인트, 3x3(300x300)와 4x4(450x450)는 6포인트예요

미국 달러 가격은 US$1 ≈ ¥6.67 기준의 추정치이며, 작업은 포인트로 차감돼요.

요청 파라미터

필드	유형	필수	설명
type	string	예	작업 유형이에요. 이 페이지의 "작업 유형 및 가격"을 참고하세요
image	string	예	질문 이미지를 Base64로 인코딩한 값이에요. data: 접두사는 포함하지 마세요
question	string	예	/m/0k4j 같은 질문 ID예요. 이 페이지의 "질문 ID"를 참고하세요
confidence	number	아니요	0에서 1 사이의 신뢰도 임계값이에요. 3x3 이미지에만 적용돼요. 값을 보내면(0.5부터 시작하는 것을 권장) 이 값보다 높은 모든 칸을 반환하고, 보내지 않으면 가능성이 가장 높은 3칸을 반환해요

주의

이미지는 아래 표의 표준 크기로 조정해야 해요. 서버가 크기를 보고 문제 유형을 판단해요.

문제 유형	이미지 크기	반환
3x3 그리드 (“모든 이미지 선택”)	300 × 300	objects: 클릭할 칸
4x4 그리드 (“모든 타일 선택”)	450 × 450	objects: 클릭할 칸
1x1 작은 이미지 (3x3에서 클릭한 뒤 새로 나타나는 단일 이미지)	100 × 100	hasObject: 이 이미지를 클릭할지 여부

스크린샷이라면 질문 문구로 구분하세요. 3x3은 “모든 이미지 선택”(Select all images with …), 4x4는 “모든 타일 선택”(Select all squares with …)이에요.

요청 예시

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "ReCaptchaV2Classification",
    "image": "BASE64_IMAGE",
    "question": "/m/0k4j"
  }
}

반환 결과

3x3, 4x4:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [1, 5, 8],
    "type": "multi"
  },
  "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b"
}

1x1 작은 이미지:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "hasObject": true,
    "type": "single"
  }
}

필드	유형	설명
objects	array	클릭해야 할 이미지의 번호예요(0부터 시작, 왼쪽에서 오른쪽, 위에서 아래 순서)
hasObject	boolean	1x1 작은 이미지일 때 반환돼요. 이 이미지에 대상이 있는지 여부예요
type	string	질문 유형이에요. multi(3x3, 4x4 큰 이미지, objects 확인), single(1x1 작은 이미지, hasObject 확인)이며, hCaptcha 드래그 질문은 drag예요

칸 번호는 0부터 시작하며, 왼쪽에서 오른쪽, 위에서 아래 순서예요.

confidence: 해당하는 칸을 한 번에 모두 반환

3x3 문제를 클릭하고 나면 보통 1x1 작은 이미지가 새로 나타나 계속 판단해야 해요. 작은 이미지를 가져오기 어렵다면(예: 모바일 개발) confidence를 보낼 수 있어요.

• 보내지 않으면 3x3 이미지는 점수가 가장 높은 3개 칸을 반환해요(reCAPTCHA는 최소 3개를 클릭해야 해요).
• 보내면(0.5 권장) 점수가 이 값보다 높은 칸을 모두 반환해요. 3개보다 많거나 적을 수 있고, 해당하는 칸이 없으면 빈 배열을 반환해요. 그러면 1x1 작은 이미지를 따로 캡처할 필요가 없어요.
• 4x4와 1x1 이미지에는 영향이 없어요.

질문 ID

question에는 질문 문구가 아니라 질문의 ID(/m/으로 시작)를 넣어요. ID는 reCAPTCHA가 문제를 불러오는 요청(reload 또는 userverify)의 응답에 이미지와 함께 내려와요. 아래 표는 자주 나오는 질문이며, 한국어 표기는 참고용이에요.

총 16개

질문 ID	질문 (영어)
/m/0pg52	taxis
/m/01bjv	bus
/m/04_sv	motorcycles
/m/013xlm	tractors
/m/01jk_4	chimneys
/m/014xcs	crosswalks
/m/015qff	traffic lights
/m/0199g	bicycles
/m/015qbp	parking meters
/m/0k4j	cars
/m/015kr	bridges
/m/019jd	boats
/m/0cdl1	palm trees
/m/09d_r	mountains or hills
/m/01pns0	fire hydrant
/m/01lynh	stairs

ERROR_UNKNOWN_QUESTION이 반환되면 ID가 잘못되었거나 아직 지원하지 않는 문제예요. ERROR_UNKNOW_450x450_QUESTION은 이 문제가 아직 4x4 이미지를 지원하지 않는다는 뜻이니, 웹 페이지에서 새로고침해 다른 문제로 바꾸면 돼요.

신고와 포인트 환불

클릭 후 검증에 실패했다면 1시간 이내에 report로 신고할 수 있어요. 약 24시간 뒤에 포인트 환불이 정산되며, 규칙은 과금과 포인트 환불에서 확인하세요. 검증을 통과한 경우에도 report로 isSuccess: true를 신고해 주세요.

관련 튜토리얼

• reCAPTCHA v2 이미지 인식으로 클릭 시뮬레이션 (Selenium)
• reCAPTCHA v2 (토큰 반환)