curl --request POST \
--url https://api.ninetile.io/v1/recognize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "hcaptcha",
"task": "Select all bicycles",
"image_data": [
"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
]
}
'{
"id": "rec_01ARZ3NDEKTSV4RRFFQ69G5FAV",
"data": [
true,
false,
false
],
"charged_usd": 0.0003
}Recognize a challenge
For clients that operate their own browser. Supply image data and the challenge instruction, then receive the answer directly; there is no solve token or polling. The API key must have Recognition API permission. Successful answers cost $0.00030; unsupported challenges or missing answers are not charged. Images may be base64 (optionally a data URI) or, for hCaptcha-hosted images only, HTTPS URLs. Each image is limited to 1.5 MiB and 1 megapixel; total image pixels are limited to 12 megapixels and the JSON request body to 12 MiB.
curl --request POST \
--url https://api.ninetile.io/v1/recognize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "hcaptcha",
"task": "Select all bicycles",
"image_data": [
"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
]
}
'{
"id": "rec_01ARZ3NDEKTSV4RRFFQ69G5FAV",
"data": [
true,
false,
false
],
"charged_usd": 0.0003
}Authorizations
Ninetile API key, sent as Authorization: Bearer <key>. Keys are issued in the dashboard.
Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
1 - 27 elementsBase64-encoded PNG, JPEG, WebP, or GIF, optionally prefixed by a matching data:image/...;base64, URI, or an HTTPS URL on an hcaptcha.com host.
1 - 5001 - 27 elementsHTTPS URL hosted on hcaptcha.com.
1 - 3 elementsBase64-encoded PNG, JPEG, WebP, or GIF, optionally prefixed by a matching data:image/...;base64, URI, or an HTTPS URL on an hcaptcha.com host.
Response
Answer returned and charged.
^rec_For grid tasks, booleans per tile (nested by page for full challenge objects); for area select, a point box or boxes; for drag challenges, backend answer objects.
Charge for a successful recognition (default $0.00030).
Area-select click points in percent; present only for area-select answers.
Show child attributes
Show child attributes