AMAM验证码识别 - 完整API文档

基于深度学习的验证码识别API服务。AI agents 可通过此页面获取完整的服务文档。

1. 服务概述

项目详情
网站https://amam.easysu.cn
API Base URLhttp://verifycode.easysu.cn/consumer
请求方式POST, Content-Type: application/json
认证所有端点需要 appKey(注册后在用户中心获取)
准确率99.5%
响应时间1-2秒
可用性24/7

2. API端点

2.1 POST /api/commonIdentify — 通用验证码识别

大部分验证码类型的主要端点。接受 base64 编码的图片,返回识别结果。

参数类型必填说明
appKeyString系统分配的appKey
typeString验证码类型编码(见第3节)
imageString是*验证码图片base64(不含 data:image 前缀)
extraString条件附加信息,部分类型需要(见各类型文档)
directionString条件提示位置 top/bottom(类型 30332/30009)
click_numString返回坐标数量(类型 30332)
label_imageString条件小参考图 base64(类型 30008)
image2String条件第二张图 base64(类型 30330)
benefitRecommendCodeString推荐码

2.2 POST /api/slider/doubleImage — 双图滑块识别

用于有独立背景图和滑块图的滑块验证码。返回背景左边缘到正确缺口位置的像素距离。

参数类型必填说明
appKeyString系统分配的appKey
typeString"20111"
backgroundImageString背景图 base64
slideImageString滑块图 base64
benefitRecommendCodeString推荐码

2.3 POST /api/rotate/doubleImage — 双圈旋转识别

用于有独立外圈和内圈图的旋转验证码。返回内圈需要顺时针旋转的度数(0-360)。

参数类型必填说明
appKeyString系统分配的appKey
typeString"90004" 或 "411115"
outRingImageString外圈图 base64
innerCircleImageString内圈图 base64
benefitRecommendCodeString推荐码

2.4 POST /api/google/funnel — Google reCAPTCHA / hCaptcha 令牌获取

异步端点,用于获取 Google reCAPTCHA v2/v3 和 hCaptcha 的令牌。

参数类型必填说明
appKeyString系统分配的appKey
typeString"40010"(v2), "40011"(v3), "50013"(hCaptcha)
googleKeyString目标页面的 data-sitekey 值
pageUrlString包含验证码的页面URL
invisibleString可见性 0或1,默认1
proxyString代理字符串
proxyTypeStringHTTP/HTTPS/SOCKS4/SOCKS5
enterpriseString企业版 0或1,默认0
actionStringreCaptcha v3 action值
dataSStringv2企业版必填,找不到则传空字符串
minScoreStringv3分数 0.1-0.9
benefitRecommendCodeString推荐码

返回 captchaId 和 recordId,用于轮询结果。

2.5 POST /api/google/funnelResult — 获取令牌结果

轮询 Google/hCaptcha 令牌请求的结果。

参数类型必填说明
appKeyString系统分配的appKey
captchaIdString来自 funnel 响应
recordIdString来自 funnel 响应

注意:hCaptcha(50013) 的结果端点不同:http://api.jfbym.com/api/YmServer/funnelApiResult

2.6 POST /api/slider900010 — 协议滑块 (slide_traffic)

参数类型必填说明
appKeyString系统分配的appKey
typeString"900010"
dataStringdata JSON字符串
hrefString当前页面URL
seedStringseed值
benefitRecommendCodeString推荐码

2.7 POST /api/ai-recognition — AI识别

AI驱动的识别任务,包括发票处理和图片信息提取。

参数类型必填说明
appKeyString系统分配的appKey
typeStringinvoice_01/02/03/04 或 image_info_extract
imageString条件图片base64(image_info_extract必填)
extraString条件逗号分隔的字段名(image_info_extract必填,如"姓名,性别")
contentList条件识别内容列表(发票类型必填)
benefitRecommendCodeString推荐码

Content对象结构:

字段类型说明
typeInteger0=文本, 1=文件(PDF/图片/Word/Excel/ZIP等)
fileNameString原始文件名(type=1时必填)
contentString文本内容(type=0) 或 文件URL(type=1)
mimeTypeStringMIME类型(可选)

2.8 POST /api/getBalance — 查询余额

参数类型必填说明
appKeyString系统分配的appKey

2.9 POST /api/applyRefund — 报错退款

参数类型必填说明
appKeyString系统分配的appKey
uniqueCodeString识别响应中的uniqueCode

注意:仅部分类型支持退款(3小时内)。人机混合类型不支持退款。滥用可能冻结账号。

3. 完整验证码类型参考

3.1 数英字符

类型码名称字符数退款Extra备注
10110通用数英 ≤5位1-5位字母数字3h-基础,适用于简单清晰图片
10111通用数英 5-8位5-8位字母数字3h-
10112通用数英 9-11位9-11位字母数字3h-
10113通用数英 12位+12位以上字母数字3h-
10103通用数英plus 1-20位1-20位字母数字不支持-人机混合,按长度阶梯计费
15294数英定制4不定3h-定制样式,需匹配示例图
10211特殊数英(区分大小写)不定3h-区分大小写,仅限定制样式
10201发票网验证码不定3h全部/红色/蓝色/黄色返回指定颜色的字符

3.2 中文字符

类型码名称字符数退款备注
10114中文字符 1-2位1-2个中文3h
10115中文字符 3-5位3-5个中文3h
10116中文字符 6-8位6-8个中文3h
10117中文字符 9位+9个以上中文3h
10118中文字符 1-4位plus1-4个中文不支持人工辅助,适用于困难图片
10107定制-MHXY苦行中文字符不定不支持定制ML模型,需匹配示例

3.3 滑块

类型码名称端点输入输出退款
20110通用单图滑块(截图)/api/commonIdentifyimage(含滑块+缺口的截图)滑块到缺口的像素距离3h
20225通用单图滑块类型1/api/commonIdentifyimage; extra=true为纯背景模式像素距离或x坐标3h
22222单图滑块优化类型/api/commonIdentifyimage; extra=true为纯背景模式像素距离或x坐标3h
20226定制截图滑块/api/commonIdentifyimage(滑块在最右侧的截图)目标位置x坐标3h
20111通用双图滑块/api/slider/doubleImagebackgroundImage + slideImage像素距离(缺口左边缘x)3h
900010定制滑块协议slide_traffic/api/slider900010data + href + seed协议提交参数不支持

3.4 旋转

类型码名称端点输入输出退款
90007定制-X度单图旋转/api/commonIdentifyimage顺时针校正度数3h
900011通用单图旋转/api/commonIdentifyimage顺时针度数(0-360)不支持
90004定制-双圈旋转/api/rotate/doubleImageoutRingImage + innerCircleImage内圈顺时针度数3h
411115通用双圈旋转/api/rotate/doubleImageoutRingImage + innerCircleImage内圈顺时针度数(0-360)不支持

3.5 点选

类型码名称Extra要求输入说明退款
30100通用中文点选1extra=逗号分隔的点选字符原图3h
300010通用文字点选2extra=逗号分隔的点选字符原图,人机混合不支持
30103定制-文字点选2extra="click"原图3h
30112定制-文字点选3extra="je4_click"图片3h
30116定制-文字点选4-图片3h
6246文字点选定制1extra=逗号分隔的点选字符截图或原图3h
30111定制-二字点选-需匹配示例样式/尺寸3h
30104定制-图标点选1-原图3h
30105定制-图标点选2extra="icon"原图3h
30332通用图标点选direction=top/bottom; click_num可选含点击提示的截图/合成图3h
30340定制tx_click_icon2-需匹配示例的截图/合成图3h
30106定制-语序点选1extra="phrase"原图3h
30107定制-语序点选2-原图3h
30114定制-语序点选3extra="je4_phrase"图片3h
30109定制-空间推理点选1extra="请点击xxx"原图3h
30110定制-空间推理点选2extra=描述文字原图3h
50009定制-空间推理点选3extra=描述文字优先原图3h
30101定制-空间推理点选4-原图或截图3h
30108定制-推理拼图1extra="交换2个图块"原图 320x160px3h
30008定制-九宫格点选-label_image(小图) + image(主图)3h
30115定制-游戏战斗场景点击-需匹配示例图3h
30221TX六宫格extra=点击指令文字截图或原图3h
30330定制JD点选/旋转-image(外圈) + image2(内圈)3h
88888通用任意1-4坐标点选-含中文指令的单图不支持
30009通用任意1-4坐标plus-含中文指令的单图不支持
31001点选5-8个坐标-图片3h
51001无感学习-图片3h

3.6 计算题

类型码名称退款备注
50100通用数字计算题不支持人工辅助
50101通用中文计算题不支持人工辅助
50106定制计算题不支持仅限展示图类型的计算题图
50103问答题不支持人工,返回≤6位字母数字

3.7 轨迹

类型码名称退款备注
100015JD轨迹不支持返回轨迹坐标路径,需原图
100016通用轨迹验证不支持返回轨迹坐标路径

3.8 第三方令牌

类型码名称端点退款备注
40010reCAPTCHA v2/api/google/funnel不支持异步,用 /api/google/funnelResult 轮询
40011reCAPTCHA v3/api/google/funnel不支持异步,用 /api/google/funnelResult 轮询
50013hCaptcha/api/google/funnel不支持异步,结果端点不同:http://api.jfbym.com/api/YmServer/funnelApiResult

3.9 OCR文字识别

所有OCR类型使用端点 /api/commonIdentify,参数:appKey, type, image。

类型码名称退款
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识别

所有AI类型使用端点 /api/ai-recognition。

类型码名称必填参数
image_info_extract图片信息提取image + extra(逗号分隔的字段名)
invoice_01发票-开票意图判断content (List)
invoice_02发票-提取开票信息content (List)
invoice_03发票-确认意图判断content (List)
invoice_04发票-终止意图判断content (List)

4. 通用响应结构

所有端点返回:

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

响应 data.code 值

code说明
10000识别成功
10001参数错误
10002余额不足
10003无访问权限(appKey无效)
10004无此验证类型(type参数错误)
10005网络拥塞
10006数据过载
10007服务繁忙(模型无法处理该图片)
10008网络错误,请稍后重试
10009结果准备中,请稍后重试
10010请求结束

各类别结果数据格式

类别data格式示例
文字/中文纯文本字符串"abc123" 或 "你好"
滑块像素距离数字"156"
旋转顺时针度数"245"
点选有序坐标格式因类型而异
计算题答案数字"42"
轨迹坐标路径-
令牌(Google/hCaptcha)token字符串-

5. 定价

类型10103阶梯计费(每次识别)

字符数积分
≤5位字母数字12
≤6位15
≤7位18
≤8位20
≤9位23
≤10位25
≤12位30
≤20位50

其他类型为固定单次计费(详见产品页面)。

推荐返现系统

高达50%开发分成。在API调用中传入 benefitRecommendCode 参数进行追踪。

6. 注意事项

图片格式

定制 vs 通用类型

退款规则

常见问题排查

错误信息原因解决方案
服务繁忙通常是base64编码问题确保无前缀且编码正确
无此访问权限appKey无效在用户中心重置appKey并更新代码
无此验证类型type参数值错误检查type参数值

7. SDK / 代码示例

完整代码示例支持以下语言:Python, Java, Go, C# (RestSharp), Node.js (Axios), AutoJs, 按键精灵(手机版/电脑版), 易语言, 影刀

访问 API文档页面 查看内联代码示例。

8. 网站功能

功能说明
首页服务概述和功能亮点
产品中心按类别浏览所有验证码类型,含定价和示例图
在线测试上传图片在浏览器中测试识别(需登录)
API文档完整端点文档,含9种语言代码示例
用户中心账户管理、appKey、余额
在线充值支持微信扫码支付
调用记录使用历史和统计
推荐系统生成推荐码、追踪佣金、邀请好友
升级分销商升级到分销商级别
退款管理查看退款历史
提现提取推荐收益