FunCaptcha 이미지 인식

FunCaptchaClassification은 FunCaptcha(Arkose Labs)의 이미지 문제를 인식해요. 문제 이미지와 영어 질문을 보내면 선택해야 할 이미지의 번호를 반환하고, 브라우저에서 클릭하는 것은 직접 작성한 프로그램이 해요. 토큰은 반환하지 않아요. 동기로 반환하며, 요청 1회당 3 포인트 (≈ $0.45 / 1k)예요.

팁

코드를 작성하지 않으려면 브라우저 확장 프로그램으로 웹 페이지에서 자동으로 처리할 수 있어요.

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

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

유형과 가격

작업 유형	가격	반환 방식	설명
FunCaptchaClassification	$0.45 / 1k; 3 포인트/작업 · ¥3 / 1k	동기

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

요청 파라미터

필드	유형	필수	설명
type	string	예	작업 유형이에요. 이 페이지의 "작업 유형 및 가격"을 참고하세요
image	string	예	질문 이미지를 Base64로 인코딩한 값이에요. data: 접두사는 포함하지 마세요
question	string	예	질문의 영어 원문(예: Pick the image that is the correct way up)이에요. 지원하는 질문은 이 페이지에서 확인하세요

• image에는 문제의 이미지 부분(6칸 그리드 또는 좌우로 합쳐진 화살표 문제 이미지)만 넣으세요. 위쪽의 제목과 버튼은 포함하지 마세요. 스크린샷은 전체가 나와야 하며, 한 부분이라도 빠지면 인식에 영향을 줘요. 세로로 배열된 6칸 그리드는 원본 이미지를 그대로 업로드하면 돼요.
• question에는 웹 페이지에 표시된 영어 질문 전체를 그대로 넣으세요. 대소문자를 정확히 지키고, 직접 번역하지 마세요. 웹 페이지가 다른 언어이면 먼저 캡차를 영어로 전환하세요. 서버가 질문을 보고 문제 유형을 판단하므로 질문이 정확해야 해요.

요청 예시

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

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "FunCaptchaClassification",
    "image": "BASE64_IMAGE",
    "question": "Pick the bread"
  }
}

반환 결과

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [4],
    "labels": ["parrot", "panda", "octopus", "owl", "bread", "dog"]
  },
  "taskId": "04a3fa76-11a0-11ed-a58c-0ef20f419382"
}

필드	유형	설명
objects	array	선택해야 할 이미지의 번호예요(0부터 시작, 왼쪽에서 오른쪽, 위에서 아래 순서)
labels	array	인식된 라벨이에요

objects: [4]는 5번째 이미지를 선택하라는 뜻이에요(번호는 0부터 시작하고, 왼쪽에서 오른쪽, 위에서 아래 순서예요). 한 문제가 여러 라운드로 이어지는 경우가 많아요. 매 라운드마다 새로 스크린샷을 찍고 다시 호출하세요.

지원하는 질문

모든 문제 유형을 지원해요. 먼저 질문 목록을 확인할 필요 없이 웹 페이지의 영어 질문과 문제 이미지를 그대로 제출하면 돼요. ERROR_UNKNOWN_QUESTION이 반환되면 고객 지원에 문의하세요.

요즘 흔한 유형은 좌우로 합쳐진 화살표 문제예요. 왼쪽은 비교할 예시이고 오른쪽은 현재 이미지이며, 웹 페이지에서 화살표로 오른쪽 이미지를 바꾸면서 질문에 맞는 이미지를 찾아요. 웹 페이지에 보이는 그대로 전체 이미지(좌우 두 부분)를 업로드하세요. 예를 들면 다음과 같아요.

Use the arrows to change the number of objects until it matches the left image개수가 왼쪽 이미지와 같아요

use the arrows to choose the image where all the darts add up to the number in the left image다트의 숫자 합이 왼쪽 이미지의 숫자와 같아요

use the arrows to find the jigsaw puzzle that is missing the puzzle piece shown on the left왼쪽에 있는 조각이 빠진 퍼즐이에요

find the image that has the prize on the left held by the claw in the machine on the right집게가 왼쪽의 상품을 잡고 있어요

다른 하나는 6칸 그리드 선택 문제(예: Pick the bread)예요. 위의 요청 예시처럼 6칸 그리드 부분만 업로드하면 돼요.

신고와 포인트 환불

한 묶음의 문제를 마지막에 제출했는데 실패했고 어느 라운드가 틀렸는지 모르겠다면, 해당 묶음의 작업 ID를 함께 report로 신고할 수 있어요(1시간 이내). 약 24시간 후에 신고 후 포인트 환불이 정산돼요. 규칙은 과금 및 포인트 환불을 참고하세요.