Authentication

Include your API key in the Authorization header.

Authorization: Bearer qc_YOUR_API_KEY

Supported hCaptcha Task Types

QCaptcha supports all major hCaptcha visual challenges:

New task types are added automatically as our AI learns.

POST /api/v1/solve

Submit captcha image for solving.

Request:

import requests

r = requests.post(
    "https://qcaptcha.ru/api/v1/solve",
    files={"image": open("captcha.png", "rb")},
    headers={"Authorization": "Bearer qc_YOUR_KEY"}
)
print(r.json())

Response:

{
  "success": true,
  "detections": [
    {
      "x": 245,
      "y": 380,
      "confidence": 0.85,
      "category": "click_shape_that_is_different"
    }
  ],
  "total_found": 1,
  "image_size": {"w": 520, "h": 570}
}

GET /api/v1/balance

Check your current balance and usage stats.

{
  "balance": 4500,
  "totalUsed": 500,
  "totalSolved": 480,
  "totalFailed": 20
}

GET /api/v1/stats

Detailed usage statistics for the last 30 days.

Error Codes