A **Matriz de capacidades** é a resposta canônica para "o que a CaptchaSonic resolve e como eu chamo?". Cada linha associa um captcha ao seu método em Python, ao seu método em Node.js, ao `task.type` REST e ao campo exato que contém a resposta. Ela é a fonte única da verdade que a documentação, os SDKs e os **agentes de IA / clientes MCP** externos utilizam.

> [!TIP]
> **Baixe a matriz em JSON** para usar em agentes, automações ou seus próprios dashboards: <a href="/capabilities.json" download>capabilities.json</a>. O JSON espelha `src/data/capabilities.ts` campo a campo.

---

## Como ler

- **Família** — `token` retorna uma string de token (insira em um campo oculto de formulário); `image` retorna coordenadas ou texto de uma imagem fornecida por você; `interactive` retorna uma ação estruturada (índices de clique, deslocamentos de arrastar, etc.).
- **SDK Python / SDK Node.js** — o nome do método e o caminho com pontos sob o objeto de resposta onde está a resposta. `not in SDK` significa que o captcha só é acessível hoje pela API REST.
- **taskType REST** — a string exata que você passa como `task.type` para `POST /createTask`. Uma variante `proxyless` separada é exibida quando a API oferece uma (ex.: `TurnstileTaskProxyless`).
- **Notas** — ressalvas fixadas (argumentos obrigatórios, requisitos de proxy, semântica de subtipos).

---

## Matriz

<CapabilityMatrix />

---

## Contagens

- **{CAPABILITY_COUNTS.total}** linhas no total — uma para cada captcha documentado.
- **{CAPABILITY_COUNTS.pythonCovered}** métodos do SDK Python e **{CAPABILITY_COUNTS.nodeCovered}** métodos do SDK Node.js (um para cada captcha).
- **{CAPABILITY_COUNTS.byFamily.token}** da família token, **{CAPABILITY_COUNTS.byFamily.image}** da família image, **{CAPABILITY_COUNTS.byFamily.interactive}** da família interactive.

Essas contagens são lidas em tempo real do `capabilities.ts` gerado, então acompanham o SDK e não podem divergir da matriz acima.

---

## Garantias de estabilidade

- **Adicionar linhas** não causa quebra de compatibilidade. Novos captchas são acrescentados ao final de `CAPABILITIES` em `src/data/capabilities.ts`.
- **Remover ou renomear um `slug`** é uma mudança que quebra compatibilidade para qualquer agente que tenha fixado nele. Não faremos isso silenciosamente.
- **Nomes de métodos e campos de retorno** espelham a documentação dos SDKs literalmente — se um método for renomeado, esta matriz é atualizada na mesma versão.

Para o contrato REST bruto, consulte a [referência da API REST](/docs/api). Para instalação e início rápido de ponta a ponta, consulte as páginas do [SDK Python](/docs/clients-sdks/python) e do [SDK Node.js](/docs/clients-sdks/nodejs).

---

## Códigos de erro

A matriz acima associa cada captcha ao seu método e campo de retorno. A tabela abaixo é a referência completa correspondente para os códigos numéricos `errorId` que todos os SDKs e a API REST retornam quando uma tarefa falha.

<ErrorIdTable />
