Die **Funktionsmatrix** ist die maßgebliche Antwort auf die Frage „Was löst CaptchaSonic, und wie rufe ich es auf?“. Jede Zeile ordnet einen CAPTCHA-Typ seiner Python-Methode, seiner Node.js-Methode, dem REST-`task.type` und dem genauen Feld zu, in dem die Antwort steht. Sie ist die einzige Referenz, auf die sich die Dokumentation, die SDKs und externe **KI-Agenten / MCP-Clients** stützen.

> [!TIP]
> **Laden Sie die Matrix als JSON herunter** für Agenten, Automatisierungen oder eigene Dashboards: <a href="/capabilities.json" download>capabilities.json</a>. Das JSON spiegelt `src/data/capabilities.ts` Feld für Feld.

---

## So lesen Sie die Matrix

- **Familie** — `token` liefert eine Token-Zeichenkette (die Sie in ein verborgenes Formularfeld einfügen); `image` liefert Koordinaten oder Text aus einem von Ihnen übergebenen Bild; `interactive` liefert eine strukturierte Aktion (Klick-Indizes, Ziehdistanzen usw.).
- **Python SDK / Node.js SDK** — der Methodenname und der Pfad mit Punkten im Antwortobjekt, unter dem die Antwort steht. `not in SDK` bedeutet, dass der CAPTCHA-Typ derzeit nur über die REST-API erreichbar ist.
- **REST taskType** — die exakte Zeichenkette, die Sie als `task.type` an `POST /createTask` übergeben. Eine separate `proxyless`-Variante wird angezeigt, wenn die API eine solche bereitstellt (z. B. `TurnstileTaskProxyless`).
- **Hinweise** — festgehaltene Einschränkungen (Pflichtargumente, Proxy-Anforderungen, Bedeutung der Untertypen).

---

## Matrix

<CapabilityMatrix />

---

## Anzahl

- **{CAPABILITY_COUNTS.total}** Zeilen insgesamt — eine pro dokumentiertem CAPTCHA-Typ.
- **{CAPABILITY_COUNTS.pythonCovered}** Python-SDK-Methoden und **{CAPABILITY_COUNTS.nodeCovered}** Node.js-SDK-Methoden (je eine pro CAPTCHA-Typ).
- **{CAPABILITY_COUNTS.byFamily.token}** Token-Familie, **{CAPABILITY_COUNTS.byFamily.image}** Bild-Familie, **{CAPABILITY_COUNTS.byFamily.interactive}** interaktive Familie.

Diese Zahlen werden live aus der generierten Datei `capabilities.ts` gelesen und bleiben daher synchron mit dem SDK; sie können nicht von der obigen Matrix abweichen.

---

## Stabilitätsgarantien

- **Neue Zeilen hinzufügen** ist nicht breaking. Neue CAPTCHA-Typen werden am Ende von `CAPABILITIES` in `src/data/capabilities.ts` angefügt.
- **Das Entfernen oder Umbenennen eines `slug`** ist eine breaking change für jeden Agenten, der sich darauf festgelegt hat. Wir tun dies nicht stillschweigend.
- **Methodennamen und Rückgabefelder** entsprechen wortgleich den SDK-Dokumenten — ändert sich ein Methodenname, wird diese Matrix im selben Release aktualisiert.

Die REST-Schnittstelle im Detail finden Sie in der [REST-API-Referenz](/docs/api). Für die Installation und den Schnellstart von Anfang bis Ende lesen Sie die Seiten zum [Python-SDK](/docs/clients-sdks/python) und zum [Node.js-SDK](/docs/clients-sdks/nodejs).

---

## Fehlercodes

Die Matrix oben ordnet jeden CAPTCHA-Typ seiner Methode und seinem Rückgabefeld zu. Die folgende Tabelle ist die passende Übersicht der numerischen `errorId`-Codes, die alle SDKs und die REST-API bei einem fehlgeschlagenen Task zurückgeben.

<ErrorIdTable />
