La **Matrice des capacités** répond de façon canonique à la question « que résout CaptchaSonic, et comment l'appeler ? ». Chaque ligne associe un CAPTCHA à sa méthode Python, sa méthode Node.js, son `task.type` REST et le champ exact qui contient la réponse. C'est la source unique de vérité que lisent la documentation, les SDK et les **agents IA / clients MCP** externes.

> [!TIP]
> **Téléchargez la matrice au format JSON** pour vos agents, vos automatisations ou vos propres tableaux de bord : <a href="/capabilities.json" download>capabilities.json</a>. Le JSON reprend `src/data/capabilities.ts` champ par champ.

---

## Comment la lire

- **Famille** — `token` renvoie un jeton sous forme de chaîne (à placer dans un champ de formulaire masqué) ; `image` renvoie des coordonnées ou du texte extraits d'une image que vous fournissez ; `interactive` renvoie une action structurée (indices de clic, déplacements de glisser, etc.).
- **SDK Python / SDK Node.js** — le nom de la méthode et le chemin pointé sous l'objet de réponse où se trouve la réponse. `not in SDK` signifie que le CAPTCHA n'est accessible aujourd'hui que via l'API REST.
- **taskType REST** — la chaîne exacte à passer comme `task.type` dans `POST /createTask`. Une variante `proxyless` distincte est indiquée lorsque l'API en propose une (par exemple `TurnstileTaskProxyless`).
- **Notes** — mises en garde fixes (arguments obligatoires, exigences de proxy, sémantique des sous-types).

---

## Matrice

<CapabilityMatrix />

---

## Chiffres

- **{CAPABILITY_COUNTS.total}** lignes au total — une par CAPTCHA documenté.
- **{CAPABILITY_COUNTS.pythonCovered}** méthodes du SDK Python et **{CAPABILITY_COUNTS.nodeCovered}** méthodes du SDK Node.js (une chacune par CAPTCHA).
- **{CAPABILITY_COUNTS.byFamily.token}** de la famille token, **{CAPABILITY_COUNTS.byFamily.image}** de la famille image, **{CAPABILITY_COUNTS.byFamily.interactive}** de la famille interactive.

Ces chiffres sont lus en direct depuis le fichier `capabilities.ts` généré : ils suivent le SDK et ne peuvent pas diverger de la matrice ci-dessus.

---

## Garanties de stabilité

- **L'ajout de lignes** n'est pas un changement cassant. Les nouveaux CAPTCHA s'ajoutent en bas de `CAPABILITIES` dans `src/data/capabilities.ts`.
- **La suppression ou le renommage d'un `slug`** est un changement cassant pour tout agent qui s'y est rattaché. Nous ne le ferons jamais silencieusement.
- **Les noms de méthodes et les champs de retour** reprennent fidèlement la documentation des SDK — si une méthode est renommée, cette matrice est mise à jour dans la même version.

Pour le contrat REST brut, consultez la [référence de l'API REST](/docs/api). Pour l'installation et le démarrage rapide, consultez les pages [SDK Python](/docs/clients-sdks/python) et [SDK Node.js](/docs/clients-sdks/nodejs).

---

## Codes d'erreur

La matrice ci-dessus associe chaque CAPTCHA à sa méthode et à son champ de retour. Le tableau ci-dessous est la référence centralisée correspondante pour les codes numériques `errorId` que chaque SDK et l'API REST renvoient lorsqu'une tâche échoue.

<ErrorIdTable />
