API Documentation

Authentication

All requests must include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST /api/v1/task

Send an image (base64) or URL to solve.

{
  "type": "image",
  "image": "<base64>"
}
{
  "task_id": "abc123"
}

GET /api/v1/task/{id}

Poll for the solution using the task ID returned by submit.

{
  "status": "solved",
  "solution": "XY93Z"
}

GET /api/v1/balance

Returns the current account balance.

{
  "balance": 9.50,
  "currency": "USD"
}

Errors

All errors return a JSON body with a code and message field.

Code Meaning
401Invalid or missing API key
402Insufficient balance
404Task not found
425Task is still processing
422Could not decode the captcha image
500Internal server error

Full reference coming soon. Contact support if you need help.