metadata
title: hCaptcha Solver
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
hCaptcha Solver API
Solves hCaptcha challenges using hcaptcha-challenger + Gemini AI.
Setup
- Go to Settings → Variables and secrets
- Add secret:
GEMINI_API_KEY→ your Google AI Studio API key
(Get one free at https://aistudio.google.com/apikey) - Optional:
GEMINI_MODEL(default:gemini-2.0-flash)
Usage
curl -X POST https://YOUR-SPACE.hf.space/solve/captcha \
-H "Content-Type: application/json" \
-d '{"url": "https://target-site.com", "sitekey": "your-sitekey"}'
Response:
{
"success": true,
"token": "P1_eyJ0eXAiOiJKV1QiLCJhbGc..."
}
Supported Challenge Types
| Type | Description |
|---|---|
image_label_single_select |
Click one matching image |
image_label_multi_select |
Click multiple matching images |
image_drag_single |
Drag one item to correct spot |
image_drag_multi |
Drag multiple items to correct spots |