Solvers

NN Recognition

How to solve NN Recognition challenges with the Astrum Solver API: parameters, request and response.

Neural-network image recognition for widget captchas that need a visual answer.

Field	Value
type	nn
Vendor	Astrum
Solution	token

Parameters

These fields go inside the task object of a createTask request. There are no optional fields for this type.

Name	Type	Description
websiteURL	stringrequired	Page that serves the challenge. Must be https and resolve to a public address.
siteKey	stringrequired	Sitekey of the widget being recognised.

Create a task

POSThttps://solver-dev.astrum.foundation/api/createTask

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "nn",
    "websiteURL": "https://target.com/login",
    "siteKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Response

{"errorId": 0, "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7"}

Collect the solution

Poll every few seconds. Until the task closes the response carries only a status; the solution appears once it does.

POSThttps://solver-dev.astrum.foundation/api/getTaskResult

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7",
    "type": "nn"
  }
}

Response

{"errorId": 0, "status": "closed", "solution": {"token": "…"}}