**기능 매트릭스**는 "CaptchaSonic이 무엇을 풀 수 있고, 어떻게 호출하나요?"에 대한 기준 자료입니다. 각 행은 CAPTCHA를 Python 메서드, Node.js 메서드, REST `task.type`, 그리고 답을 담고 있는 정확한 필드에 연결합니다. 문서, SDK, 외부 **AI 에이전트 / MCP 클라이언트**가 모두 참조하는 단일 기준 자료입니다.

> [!TIP]
> 에이전트, 자동화, 또는 자체 대시보드에서 사용할 수 있도록 **매트릭스를 JSON으로 다운로드**하세요: <a href="/capabilities.json" download>capabilities.json</a>. 이 JSON은 `src/data/capabilities.ts`와 필드 단위로 동일합니다.

---

## 읽는 방법

- **패밀리** — `token`은 문자열 토큰을 반환합니다(숨겨진 폼 필드에 넣으면 됩니다). `image`는 제공한 이미지에서 좌표나 텍스트를 반환합니다. `interactive`는 구조화된 동작(클릭 인덱스, 드래그 이동량 등)을 반환합니다.
- **Python SDK / Node.js SDK** — 메서드 이름과, 응답 객체에서 답이 들어 있는 점 표기 경로입니다. `not in SDK`는 해당 CAPTCHA를 현재 REST API로만 사용할 수 있다는 뜻입니다.
- **REST taskType** — `POST /createTask`에 `task.type`으로 전달하는 정확한 문자열입니다. API가 별도의 `proxyless` 변형을 제공하는 경우(예: `TurnstileTaskProxyless`) 이를 함께 표시합니다.
- **비고** — 고정된 주의 사항(필수 인자, 프록시 요구 사항, 하위 유형의 의미)입니다.

---

## 매트릭스

<CapabilityMatrix />

---

## 개수

- 총 **{CAPABILITY_COUNTS.total}**개 행 — 문서화된 CAPTCHA당 한 행입니다.
- Python SDK 메서드 **{CAPABILITY_COUNTS.pythonCovered}**개, Node.js SDK 메서드 **{CAPABILITY_COUNTS.nodeCovered}**개(CAPTCHA당 각 하나씩)입니다.
- token 패밀리 **{CAPABILITY_COUNTS.byFamily.token}**개, image 패밀리 **{CAPABILITY_COUNTS.byFamily.image}**개, interactive 패밀리 **{CAPABILITY_COUNTS.byFamily.interactive}**개입니다.

이 개수는 생성된 `capabilities.ts`에서 실시간으로 읽히므로, 위 매트릭스와 어긋날 수 없습니다.

---

## 안정성 보장

- **행 추가**는 호환성을 깨지 않습니다. 새 CAPTCHA는 `src/data/capabilities.ts`의 `CAPABILITIES` 맨 아래에 추가됩니다.
- **`slug` 제거 또는 이름 변경**은 해당 slug를 고정해 사용하는 모든 에이전트에 호환성을 깨는 변경입니다. 이런 변경은 조용히 하지 않습니다.
- **메서드 이름과 반환 필드**는 SDK 문서와 글자 그대로 일치합니다. 메서드 이름이 바뀌면 이 매트릭스도 같은 릴리스에서 업데이트됩니다.

원시 REST 계약은 [REST API 레퍼런스](/docs/api)를 참고하세요. 설치와 빠른 시작 전체 과정은 [Python SDK](/docs/clients-sdks/python) 및 [Node.js SDK](/docs/clients-sdks/nodejs) 페이지를 참고하세요.

---

## 오류 코드

위 매트릭스는 각 CAPTCHA를 메서드와 반환 필드에 연결합니다. 아래 표는 작업이 실패할 때 모든 SDK와 REST API가 반환하는 숫자형 `errorId` 코드를 한곳에서 확인할 수 있는 대응 자료입니다.

<ErrorIdTable />
