**Ma trận khả năng** là câu trả lời chuẩn cho câu hỏi "CaptchaSonic giải được những gì, và tôi gọi nó như thế nào?". Mỗi dòng ghim một captcha vào phương thức Python, phương thức Node.js, `task.type` của REST và trường chính xác chứa đáp án. Đây là nguồn chuẩn duy nhất mà tài liệu, các SDK và **AI agent / MCP client** bên ngoài đều đọc từ đó.

> [!TIP]
> **Tải ma trận dưới dạng JSON** để dùng trong agent, tự động hóa hoặc dashboard riêng của bạn: <a href="/capabilities.json" download>capabilities.json</a>. Tệp JSON phản chiếu `src/data/capabilities.ts` theo từng trường.

---

## Cách đọc

- **Family** — `token` trả về một chuỗi token (đưa vào trường form ẩn); `image` trả về tọa độ hoặc văn bản từ ảnh bạn cung cấp; `interactive` trả về một hành động có cấu trúc (chỉ số nhấp, độ lệch kéo, v.v.).
- **Python SDK / Node.js SDK** — tên phương thức và đường dẫn có dấu chấm trong đối tượng phản hồi nơi chứa đáp án. `not in SDK` nghĩa là captcha đó hiện chỉ dùng được qua REST API.
- **REST taskType** — chuỗi chính xác bạn truyền làm `task.type` cho `POST /createTask`. Biến thể `proxyless` riêng được hiển thị khi API có hỗ trợ (ví dụ `TurnstileTaskProxyless`).
- **Ghi chú** — các lưu ý cố định (tham số bắt buộc, yêu cầu proxy, ý nghĩa subtype).

---

## Ma trận

<CapabilityMatrix />

---

## Số liệu

- **{CAPABILITY_COUNTS.total}** dòng tổng cộng — mỗi captcha có tài liệu một dòng.
- **{CAPABILITY_COUNTS.pythonCovered}** phương thức Python SDK và **{CAPABILITY_COUNTS.nodeCovered}** phương thức Node.js SDK (mỗi captcha một phương thức).
- **{CAPABILITY_COUNTS.byFamily.token}** thuộc họ token, **{CAPABILITY_COUNTS.byFamily.image}** thuộc họ image, **{CAPABILITY_COUNTS.byFamily.interactive}** thuộc họ interactive.

Các số liệu này được đọc trực tiếp từ `capabilities.ts` đã được sinh ra, nên luôn khớp với SDK và không lệch khỏi ma trận ở trên.

---

## Cam kết ổn định

- **Thêm dòng** không gây lỗi tương thích. Captcha mới được thêm vào cuối `CAPABILITIES` trong `src/data/capabilities.ts`.
- **Xóa hoặc đổi tên `slug`** là thay đổi phá vỡ tương thích đối với mọi agent đã ghim vào nó. Chúng tôi sẽ không làm việc này âm thầm.
- **Tên phương thức và trường trả về** phản chiếu nguyên văn tài liệu SDK — nếu một phương thức đổi tên, ma trận này sẽ được cập nhật trong cùng bản phát hành.

Để xem hợp đồng REST thô, hãy xem [tham chiếu REST API](/docs/api). Để cài đặt và bắt đầu nhanh từ đầu đến cuối, xem các trang [Python SDK](/docs/clients-sdks/python) và [Node.js SDK](/docs/clients-sdks/nodejs).

---

## Mã lỗi

Ma trận ở trên ghim mỗi captcha với phương thức và trường trả về của nó. Bảng dưới đây là tài liệu tham chiếu tổng hợp tương ứng cho các mã `errorId` dạng số mà mọi SDK và REST API trả về khi một tác vụ thất bại.

<ErrorIdTable />
