---
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 |