# amam验证码识别 (AMAM Captcha Recognition Service)

> AI-powered captcha recognition service with 70+ supported types, 99.5% accuracy, 1-2s response time, 24/7 availability.

## About

amam验证码识别 is a captcha recognition API service based on deep learning. It provides HTTP API endpoints for recognizing various types of captchas including text, slider, rotation, click-selection, calculation, trajectory, OCR, and third-party captchas (Google reCAPTCHA, hCaptcha). The service supports multiple programming languages (Python, Java, Go, C#, Node.js, AutoJs, etc.).

- Website: https://amam.easysu.cn
- API Base URL: http://verifycode.easysu.cn/consumer
- Request Method: POST
- Content-Type: application/json

## Quick Links

- [Full API Documentation](/llms-full.txt)
- [Full API Documentation (HTML)](/docs-full.html)
- [API Summary (HTML)](/docs.html)
- [OpenAPI Specification](/openapi.json)

## Authentication

All API calls require an `appKey` parameter. Users obtain their appKey after registering and logging in at the website user center.

## API Endpoints Overview

1. POST /api/commonIdentify - General captcha recognition (most types)
2. POST /api/slider/doubleImage - Dual-image slider recognition
3. POST /api/rotate/doubleImage - Dual-circle rotation recognition
4. POST /api/google/funnel - Google reCAPTCHA / hCaptcha token acquisition
5. POST /api/google/funnelResult - Get result by captcha token
6. POST /api/slider900010 - Protocol-based slider (slide_traffic)
7. POST /api/ai-recognition - AI recognition (invoice, image info extraction)
8. POST /api/getBalance - Check account balance
9. POST /api/applyRefund - Error refund request

## Supported Captcha Categories

### Text Recognition (数英/中文字符)
- 10110: Alphanumeric ≤5 chars
- 10111: Alphanumeric 5-8 chars
- 10112: Alphanumeric 9-11 chars
- 10113: Alphanumeric 12+ chars
- 10103: Alphanumeric 1-20 chars (human-machine hybrid, tiered pricing)
- 10114: Chinese 1-2 chars
- 10115: Chinese 3-5 chars
- 10116: Chinese 6-8 chars
- 10117: Chinese 9+ chars
- 10118: Chinese 1-4 chars plus (human-assisted)
- 10107: Custom MHXY Chinese chars
- 10201: Custom color-specific chars (extra: 全部/红色/蓝色/黄色)
- 10211: Custom case-sensitive chars
- 15294: Custom specific style chars

### Slider (滑块)
- 20110: Single-image slider (screenshot, returns pixel distance)
- 20225: Single-image slider (screenshot or background, extra=true for x-coordinate)
- 22222: Single-image slider optimized
- 20226: Custom screenshot slider
- 20111: Dual-image slider (background + slide images, endpoint: /api/slider/doubleImage)
- 900010: Protocol slider slide_traffic (endpoint: /api/slider900010)

### Rotation (旋转)
- 90007: Custom single-image rotation (returns clockwise degrees)
- 900011: General single-image rotation (human-assisted, 0-360 degrees)
- 90004: Custom dual-circle rotation (endpoint: /api/rotate/doubleImage)
- 411115: General dual-circle rotation (human-assisted, endpoint: /api/rotate/doubleImage)

### Click Selection (点选)
- 30100: General text click (extra: comma-separated chars to click)
- 300010: General text click v2 (extra: comma-separated chars, human-machine hybrid)
- 30103: Custom text click 2 (extra="click")
- 30112: Custom text click 3 (extra="je4_click")
- 30116: Custom text click 4
- 6246: Custom text click type 1 (extra: comma-separated chars)
- 30111: Custom two-char click
- 30104: Custom icon click 1 (original image)
- 30105: Custom icon click 2 (extra="icon")
- 30332: General icon click (direction=top/bottom required, click_num optional)
- 30340: Custom icon click tx_click_icon2
- 30106: Custom phrase click 1 (extra="phrase")
- 30107: Custom phrase click 2
- 30114: Custom phrase click 3 (extra="je4_phrase")
- 30109: Custom spatial reasoning click 1 (extra="请点击xxx")
- 30110: Custom spatial reasoning click 2 (extra=description)
- 50009: Custom spatial reasoning click 3 (extra=description)
- 30101: Custom spatial reasoning click 4
- 30108: Custom puzzle swap (extra="交换2个图块", image 320x160px)
- 30008: Custom 9-grid click (label_image + image)
- 30115: Custom game scene click
- 30221: TX 6-grid click (extra: click instruction text)
- 30330: Custom JD click/rotation (image + image2)
- 88888: General 1-4 coordinate click (human, no extra)
- 30009: General 1-4 coordinate click plus (human, no extra)
- 31001: Click 5-8 coordinates
- 51001: Imperceptible learning

### Calculation (计算题)
- 50100: Numeric calculation (human-assisted)
- 50101: Chinese calculation (human-assisted)
- 50106: Custom calculation (specific display-image style only)
- 50103: Q&A type (human, returns alphanumeric ≤6 chars)

### Trajectory (轨迹)
- 100015: JD trajectory (returns coordinate path)
- 100016: General trajectory (returns coordinate path)

### Third-Party Token (第三方令牌)
- 40010: Google reCAPTCHA v2 (async, endpoint: /api/google/funnel)
- 40011: Google reCAPTCHA v3 (async, endpoint: /api/google/funnel)
- 50013: hCaptcha (async, endpoint: /api/google/funnel, result endpoint: http://api.jfbym.com/api/YmServer/funnelApiResult)

### OCR (文字识别)
- ocr_001: General text OCR - Standard
- ocr_002: General text OCR - High precision
- ocr_003: General text OCR - Lite
- ocr_004: General text OCR - High speed
- ocr_005: Table recognition
- ocr_006: ID card recognition
- ocr_007: Bank card recognition
- ocr_008: License plate recognition
- ocr_009: VAT invoice recognition
- ocr_010: Taxi receipt recognition
- ocr_011: Train ticket recognition

### AI Recognition (AI识别)
- image_info_extract: Image info extraction (extra: comma-separated field names, endpoint: /api/ai-recognition)
- invoice_01: Invoice - billing intent (endpoint: /api/ai-recognition)
- invoice_02: Invoice - extract billing info (endpoint: /api/ai-recognition)
- invoice_03: Invoice - confirmation intent (endpoint: /api/ai-recognition)
- invoice_04: Invoice - termination intent (endpoint: /api/ai-recognition)

## Common Response Structure

```json
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "code": 10000,
      "data": "recognition_result",
      "time": "1234ms",
      "uniqueCode": "unique_request_id"
    }
  ],
  "success": true
}
```

## Response Codes

- 10000: Success
- 10001: Parameter error
- 10002: Insufficient balance
- 10003: No access permission (invalid appKey)
- 10004: Invalid captcha type
- 10005: Network congestion
- 10006: Data overload
- 10007: Service busy (model cannot process image)
- 10008: Network error, retry later
- 10009: Result preparing, retry later
- 10010: Request ended

## Refund Policy

- Types supporting refund: must report within 3 hours via POST /api/applyRefund with uniqueCode
- Human/machine hybrid types: do NOT support refund
- Abuse of refund may result in account freeze

## Pricing

- Tiered pricing by captcha type and complexity
- Type 10103 tiered pricing: ≤5 chars: 12, ≤6: 15, ≤7: 18, ≤8: 20, ≤9: 23, ≤10: 25, ≤12: 30, ≤20: 50 (units per recognition)
- Referral commission system with 高达50%开发分成 (up to 50% developer commission)
- benefitRecommendCode parameter available on most endpoints for tracking referrals

## SDK / Code Samples

Available in: Python, Java, Go, C#, Node.js (Axios), AutoJs, 按键精灵 (mobile/PC), 易语言, 影刀