| --- |
| title: hCaptcha Solver |
| emoji: 🤖 |
| colorFrom: blue |
| colorTo: purple |
| sdk: docker |
| pinned: false |
| --- |
| |
| # hCaptcha Solver API |
|
|
| Solves hCaptcha challenges using `hcaptcha-challenger` + Gemini AI. |
|
|
| ## Setup |
|
|
| 1. Go to **Settings → Variables and secrets** |
| 2. Add secret: `GEMINI_API_KEY` → your Google AI Studio API key |
| (Get one free at https://aistudio.google.com/apikey) |
| 3. Optional: `GEMINI_MODEL` (default: `gemini-2.0-flash`) |
|
|
| ## Usage |
|
|
| ```bash |
| 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: |
| ```json |
| { |
| "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 | |
|
|
