# amam验证码识别 - Complete API Documentation (llms-full.txt)

> This file contains the complete, machine-readable documentation for the AMAM Captcha Recognition Service.
> AI agents can read this single file to understand all available services, endpoints, parameters, and captcha types.

---

## 1. Service Overview

amam验证码识别 is a captcha recognition API service based on deep learning and human-assisted recognition.
- Website: https://amam.easysu.cn
- API Base URL: http://verifycode.easysu.cn/consumer
- All API requests use POST method with Content-Type: application/json
- Authentication: All endpoints require `appKey` (obtained from user center after registration)
- Accuracy: 99.5%
- Average response: 1-2 seconds
- Availability: 24/7

---

## 2. API Endpoints

### 2.1 POST /api/commonIdentify — General Captcha Recognition

The primary endpoint for most captcha types. Accepts a base64-encoded image and returns the recognition result.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | Captcha type code (see Section 3) |
| image | String | Yes* | Captcha image in base64 (without data:image prefix) |
| extra | String | Conditional | Additional info, required by some types (see per-type docs) |
| direction | String | Conditional | Hint position (top/bottom), required for type 30332/30009 |
| click_num | String | No | Number of coordinates to return (type 30332) |
| label_image | String | Conditional | Small reference image base64 (type 30008) |
| image2 | String | Conditional | Second image base64 (type 30330) |
| benefitRecommendCode | String | No | Referral code for cashback tracking |

*Note: `image` is required for most types. For type 900010, use dedicated endpoint instead.

### 2.2 POST /api/slider/doubleImage — Dual-Image Slider

For slider captchas with separate background and slide images.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | "20111" |
| backgroundImage | String | Yes | Background image base64 |
| slideImage | String | Yes | Slide piece image base64 |
| benefitRecommendCode | String | No | Referral code |

Returns: pixel distance from left edge of background to correct gap position.

### 2.3 POST /api/rotate/doubleImage — Dual-Circle Rotation

For rotation captchas with separate outer ring and inner circle images.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | "90004" or "411115" |
| outRingImage | String | Yes | Outer ring image base64 |
| innerCircleImage | String | Yes | Inner circle image base64 |
| benefitRecommendCode | String | No | Referral code |

Returns: clockwise degrees (0-360) the inner circle needs to rotate to align, with outer ring fixed.

### 2.4 POST /api/google/funnel — Google reCAPTCHA / hCaptcha Token

Async endpoint for obtaining tokens for Google reCAPTCHA v2/v3 and hCaptcha.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | "40010" (v2), "40011" (v3), or "50013" (hCaptcha) |
| googleKey | String | Yes | data-sitekey value from target page |
| pageUrl | String | Yes | URL of the page with captcha |
| invisible | String | No | Visibility type 0 or 1, default 1 |
| proxy | String | No | Proxy string |
| proxyType | String | No | HTTP, HTTPS, SOCKS4, or SOCKS5 |
| enterprise | String | No | Enterprise version 0 or 1, default 0 |
| action | String | No | reCaptcha v3 action value |
| dataS | String | No | Required for v2 enterprise, empty string if not found |
| minScore | String | No | v3 score 0.1-0.9 |
| benefitRecommendCode | String | No | Referral code |

Returns: captchaId and recordId for polling result.

### 2.5 POST /api/google/funnelResult — Get Token Result

Poll for the result of a Google/hCaptcha token request.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| captchaId | String | Yes | From funnel response |
| recordId | String | Yes | From funnel response |

### 2.6 POST /api/slider900010 — Protocol Slider (slide_traffic)

For protocol-based slider captchas.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | "900010" |
| data | String | Yes | data JSON string |
| href | String | Yes | Current page URL |
| seed | String | Yes | seed value |
| benefitRecommendCode | String | No | Referral code |

### 2.7 POST /api/ai-recognition — AI Recognition

For AI-powered recognition tasks including invoice processing and image info extraction.

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| type | String | Yes | invoice_01, invoice_02, invoice_03, invoice_04, or image_info_extract |
| image | String | Conditional | Image base64 (required for image_info_extract) |
| extra | String | Conditional | Field names comma-separated (required for image_info_extract, e.g. "姓名,性别") |
| content | List<Content> | Conditional | Recognition content (required for invoice types) |
| benefitRecommendCode | String | No | Referral code |

Content object structure:
| Field | Type | Description |
|-------|------|-------------|
| type | Integer | 0=text, 1=file (PDF, image, Word, Excel, ZIP, etc.) |
| fileName | String | Original filename (required for type=1) |
| content | String | Text content (type=0) or file URL (type=1) |
| mimeType | String | MIME type (optional) |

### 2.8 POST /api/getBalance — Check Balance

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |

### 2.9 POST /api/applyRefund — Error Refund

Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| appKey | String | Yes | System-issued appKey |
| uniqueCode | String | Yes | uniqueCode from recognition response |

Note: Only some types support refund (within 3 hours). Human/machine hybrid types do NOT support refund. Abuse may freeze account.

---

## 3. Complete Captcha Type Reference

### 3.1 Text Recognition (数英字符)

| Type | Name | Chars | Refund | Extra | Notes |
|------|------|-------|--------|-------|-------|
| 10110 | 通用数英 ≤5位 | 1-5 alphanumeric | 3h | - | Basic, for simple clear images |
| 10111 | 通用数英 5-8位 | 5-8 alphanumeric | 3h | - | |
| 10112 | 通用数英 9-11位 | 9-11 alphanumeric | 3h | - | |
| 10113 | 通用数英 12位+ | 12+ alphanumeric | 3h | - | |
| 10103 | 通用数英plus 1-20位 | 1-20 alphanumeric | No | - | Human-machine hybrid, tiered pricing by length |
| 15294 | 数英定制4 | varies | 3h | - | Custom style, must match example images |
| 10211 | 特殊数英(区分大小写) | varies | 3h | - | Case-sensitive, custom style only |
| 10201 | 发票网验证码 | varies | 3h | extra=全部/红色/蓝色/黄色 | Returns chars of specified color |

### 3.2 Chinese Character Recognition (中文字符)

| Type | Name | Chars | Refund | Notes |
|------|------|-------|--------|-------|
| 10114 | 中文字符 1-2位 | 1-2 Chinese | 3h | |
| 10115 | 中文字符 3-5位 | 3-5 Chinese | 3h | |
| 10116 | 中文字符 6-8位 | 6-8 Chinese | 3h | |
| 10117 | 中文字符 9位及以上 | 9+ Chinese | 3h | |
| 10118 | 中文字符 1-4位 plus | 1-4 Chinese | No | Human-assisted, for difficult images |
| 10107 | 定制-MHXY苦行中文字符 | varies | No | Custom ML model, must match examples |

### 3.3 Slider (滑块)

| Type | Name | Endpoint | Input | Output | Refund |
|------|------|----------|-------|--------|--------|
| 20110 | 通用单图滑块(截图) | /api/commonIdentify | image (screenshot with slider+gap) | Pixel distance from slider to gap | 3h |
| 20225 | 通用单图滑块类型1 | /api/commonIdentify | image; extra=true for background-only mode | Pixel distance or x-coordinate | 3h |
| 22222 | 单图滑块优化类型 | /api/commonIdentify | image; extra=true for background-only mode | Pixel distance or x-coordinate | 3h |
| 20226 | 定制截图滑块 | /api/commonIdentify | image (screenshot with slider at rightmost) | x-coordinate of target position | 3h |
| 20111 | 通用双图滑块 | /api/slider/doubleImage | backgroundImage + slideImage | Pixel distance (gap left edge x) | 3h |
| 900010 | 定制滑块协议slide_traffic | /api/slider900010 | data + href + seed | Protocol submission parameter | No |

### 3.4 Rotation (旋转)

| Type | Name | Endpoint | Input | Output | Refund |
|------|------|----------|-------|--------|--------|
| 90007 | 定制-X度单图旋转 | /api/commonIdentify | image | Clockwise degrees to correct | 3h |
| 900011 | 通用单图旋转 | /api/commonIdentify | image | Clockwise degrees (0-360) | No |
| 90004 | 定制-双圈旋转 | /api/rotate/doubleImage | outRingImage + innerCircleImage | Inner circle clockwise degrees | 3h |
| 411115 | 通用双圈旋转 | /api/rotate/doubleImage | outRingImage + innerCircleImage | Inner circle clockwise degrees (0-360) | No |

### 3.5 Click Selection (点选)

| Type | Name | Extra Required | Input Notes | Output | Refund |
|------|------|----------------|-------------|--------|--------|
| 30100 | 通用中文点选1 | extra=逗号分隔的点选字符 | Original image | Ordered coordinates | 3h |
| 300010 | 通用文字点选2 | extra=逗号分隔的点选字符 | Original image, human-machine hybrid | Ordered coordinates | No |
| 30103 | 定制-文字点选2 | extra="click" | Original image | Ordered coordinates | 3h |
| 30112 | 定制-文字点选3 | extra="je4_click" | Image | Ordered coordinates | 3h |
| 30116 | 定制-文字点选4 | - | Image | Ordered coordinates | 3h |
| 6246 | 文字点选定制1 | extra=逗号分隔的点选字符 (screenshot: optional) | Screenshot or original | Ordered coordinates | 3h |
| 30111 | 定制-二字点选 | - | Image matching example style/size | Ordered coordinates | 3h |
| 30104 | 定制-图标点选1 | - | Original image | Ordered coordinates | 3h |
| 30105 | 定制-图标点选2 | extra="icon" | Original image | Ordered coordinates | 3h |
| 30332 | 通用图标点选 | direction=top/bottom; click_num (optional) | Screenshot/composite with click hints | Ordered coordinates | 3h |
| 30340 | 定制tx_click_icon2 | - | Screenshot/composite matching examples | Ordered coordinates | 3h |
| 30106 | 定制-语序点选1 | extra="phrase" | Original image | Ordered coordinates | 3h |
| 30107 | 定制-语序点选2 | - | Original image | Ordered coordinates | 3h |
| 30114 | 定制-语序点选3 | extra="je4_phrase" | Image | Ordered coordinates | 3h |
| 30109 | 定制-空间推理点选1 | extra="请点击xxx" | Original image | Coordinates | 3h |
| 30110 | 定制-空间推理点选2 | extra=description text | Original image | Coordinates | 3h |
| 50009 | 定制-空间推理点选3 | extra=description text | Preferably original image | Coordinates | 3h |
| 30101 | 定制-空间推理点选4 | - | Original or screenshot | Coordinates | 3h |
| 30108 | 定制-推理拼图1 | extra="交换2个图块" | Original image 320x160px | Two center-point coordinates | 3h |
| 30008 | 定制-九宫格点选 | - | label_image (small) + image (main) | Coordinates | 3h |
| 30115 | 定制-游戏战斗场景点击 | - | Image matching examples | Coordinates | 3h |
| 30221 | TX六宫格 | extra=click instruction text | Screenshot or original | Coordinates | 3h |
| 30330 | 定制JD点选/旋转 | - | image (outer) + image2 (inner circle) | Coordinates or rotation degrees | 3h |
| 88888 | 通用任意1-4坐标点选 | - | Single image with Chinese instructions on it | Ordered coordinates | No |
| 30009 | 通用任意1-4坐标plus | - | Single image with Chinese instructions on it | Ordered coordinates | No |
| 31001 | 点选5-8个坐标 | - | Image | Coordinates | 3h |
| 51001 | 无感学习 | - | Image | Recognition result | 3h |

### 3.6 Calculation (计算题)

| Type | Name | Refund | Notes |
|------|------|--------|-------|
| 50100 | 通用数字计算题 | No | Human-assisted |
| 50101 | 通用中文计算题 | No | Human-assisted |
| 50106 | 定制计算题 | No | Specific display-image style calculation only (本接口只能识别展示图类型的计算题图) |
| 50103 | 问答题 | No | Human, returns alphanumeric ≤6 chars |

### 3.7 Trajectory (轨迹)

| Type | Name | Refund | Notes |
|------|------|--------|-------|
| 100015 | JD轨迹 | No | Returns trajectory coordinate path, needs original image |
| 100016 | 通用轨迹验证 | No | Returns trajectory coordinate path |

### 3.8 Third-Party Token (第三方令牌)

| Type | Name | Endpoint | Refund | Notes |
|------|------|----------|--------|-------|
| 40010 | reCAPTCHA v2 | /api/google/funnel | No | Async, poll with /api/google/funnelResult |
| 40011 | reCAPTCHA v3 | /api/google/funnel | No | Async, poll with /api/google/funnelResult |
| 50013 | hCaptcha | /api/google/funnel | No | Async, poll with /api/google/funnelResult (different result endpoint) |

hCaptcha result endpoint: http://api.jfbym.com/api/YmServer/funnelApiResult

### 3.9 OCR (文字识别)

All OCR types use endpoint /api/commonIdentify with params: appKey, type, image.

| Type | Name | Refund |
|------|------|--------|
| ocr_001 | 通用文字识别-标准版 | 3h |
| ocr_002 | 通用文字识别-高精度版 | 3h |
| ocr_003 | 通用文字识别-精简版 | 3h |
| ocr_004 | 通用文字识别-高速版 | 3h |
| ocr_005 | 表格识别 | 3h |
| ocr_006 | 卡证识别-身份证 | 3h |
| ocr_007 | 卡证识别-银行卡 | 3h |
| ocr_008 | 卡证识别-车牌 | 3h |
| ocr_009 | 卡证识别-增值税发票 | 3h |
| ocr_010 | 卡证识别-出租车票 | 3h |
| ocr_011 | 卡证识别-火车票 | 3h |

### 3.10 AI Recognition (AI识别)

All AI types use endpoint /api/ai-recognition.

| Type | Name | Required Params |
|------|------|-----------------|
| image_info_extract | 图片信息提取 | image + extra (comma-separated field names) |
| invoice_01 | 发票-开票意图判断 | content (List<Content>) |
| invoice_02 | 发票-提取开票信息 | content (List<Content>) |
| invoice_03 | 发票-确认意图判断 | content (List<Content>) |
| invoice_04 | 发票-终止意图判断 | content (List<Content>) |

---

## 4. Common Response Structure

All endpoints return:
```json
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "code": 10000,
      "data": "<recognition_result>",
      "time": "1234ms",
      "uniqueCode": "unique_request_identifier"
    }
  ],
  "success": true
}
```

### Response data.code values:
- 10000: Recognition success
- 10001: Parameter error
- 10002: Insufficient balance
- 10003: No access permission (invalid appKey)
- 10004: Invalid captcha type (wrong type parameter)
- 10005: Network congestion
- 10006: Data overload
- 10007: Service busy (model cannot process the image)
- 10008: Network error, retry later
- 10009: Result preparing, retry later
- 10010: Request ended

### Result data format by category:
- Text/Chinese: plain text string (e.g. "abc123" or "你好")
- Slider: pixel distance number (e.g. "156")
- Rotation: clockwise degrees (e.g. "245")
- Click selection: ordered coordinates (format varies by type)
- Calculation: answer number (e.g. "42")
- Trajectory: coordinate path
- Token (Google/hCaptcha): token string

---

## 5. Pricing

### Type 10103 Tiered Pricing (per recognition):
- ≤5 chars alphanumeric: 12 credits
- ≤6 chars: 15 credits
- ≤7 chars: 18 credits
- ≤8 chars: 20 credits
- ≤9 chars: 23 credits
- ≤10 chars: 25 credits
- ≤12 chars: 30 credits
- ≤20 chars: 50 credits

Other types have fixed per-call pricing (available on the product page).

### Referral System:
- 高达50%开发分成 (up to 50% developer commission)
- Pass `benefitRecommendCode` parameter in API calls for tracking

---

## 6. Important Notes

### Image Format:
- All image parameters accept base64-encoded strings
- Common practice: strip the `data:image/xxx;base64,` prefix if present (the online test tool does this automatically)

### Custom vs General Types:
- Types prefixed with "定制" (custom) are trained on specific image styles — your images must match the example images
- Types prefixed with "通用" (general) work on a broader range of images

### Refund Rules:
- Types marked "3h refund" support error reporting within 3 hours via /api/applyRefund
- Types marked "No refund" (human/machine hybrid) do NOT support refund
- Do not abuse refund — accounts may be frozen

### Troubleshooting:
- "服务繁忙" (Service busy): Usually a base64 encoding issue — ensure no prefix and correct encoding
- "无此访问权限" (No permission): Reset appKey in user center and update in code
- "无此验证类型" (Invalid type): Check the type parameter value

---

## 7. Code Examples

Complete working code samples are available on the documentation page in the following languages:
- Python (full API client class with all endpoints)
- Java
- Go
- C# (RestSharp)
- Node.js (Axios, full API client class with all endpoints)
- AutoJs
- 按键精灵 手机版
- 按键精灵 电脑版
- 易语言 (download: http://doc.easysu.cn/code/易语言/amam验证码-易语言调用.zip)
- 影刀 (download: http://doc.easysu.cn/code/影刀/EasySuVerify_指令集更新程序.zip)

Visit the API documentation page at https://amam.easysu.cn/#/doc for inline code samples, or individual type documentation pages for type-specific usage.

---

## 8. Website Features

- Homepage: Service overview and feature highlights
- Product Center: Browse all captcha types by category with pricing and demo images
- Online Test: Upload images and test recognition in browser (requires login)
- API Documentation: Complete endpoint docs with code samples in 9 languages
- User Center: Account management, appKey, balance
- Charging: Online top-up (在线充值), supports WeChat QR code payment (微信扫码支付)
- Invoke Records: Usage history and statistics
- Referral System: Generate referral codes, track commissions, invite friends
- Distributor Upgrade: Upgrade to distributor level (升级分销商)
- Friends: View referred friends list
- Refund Management: View refund history
- Withdrawal: Cash out referral earnings
- Illegal Activity Report: Report illegal use of the service