小影API 小影API

驗證碼識別

多引擎验证码识别：ddddocr 本地模型（OCR 文字识别 / 目标检测 / 滑块缺口匹配）与超级鹰打码平台（通用图片识别 / 报错返分 / 查询题分）。

/api/ddddocr/

服務說明

验证码识别服务按「线路」聚合多种识别引擎：当前接入 ddddocr（本地模型）与 超级鹰（第三方打码平台），在上方线路 Tab 之间切换即可查看各自的接口与调试面板。

ddddocr 线路（/api/ddddocr/）：纯本地模型，无需第三方账号、无额外费用。识别图片中的文字、检测图片内的目标位置，以及匹配滑块验证码的缺口位置（两种算法）。识别实例的字符范围可配置（预定义编号或自定义字符集），识别特定站点的验证码前先设置字符集通常能明显提升准确率。

超级鹰线路（/api/chaojiying/）：第三方人工 + 智能打码平台，通用图片识别，账号由本站统一配置、调用方无需自备。按题分计费，上传即扣费（无论最终识别对错）；官方标准价 1 元 = 1000 题分（充值有赠送，实际单价低于此）。调用前请用 codetype 精确匹配图片内容 —— 类型选得越准，识别越快越准，花费也越低。各识别类型的官方单价与折合人民币如下：

识别类型 说明 题分 折合人民币（约）
1902 4~6位英文数字 10/12/15 0.01~0.015 元
1004 1~4位英文数字 10 0.01 元
1005 1~5位英文数字 12 0.012 元
1006 1~6位英文数字 15 0.015 元
1007 1~7位英文数字 17.5 0.0175 元
1008 1~8位英文数字 20 0.02 元
1009 1~9位英文数字 22.5 0.0225 元
1010 1~10位英文数字 25 0.025 元
1012 1~12位英文数字 30 0.03 元
1020 1~20位英文数字 50 0.05 元
2001 1位纯汉字 10 0.01 元
2002 1~2位纯汉字 20 0.02 元
2003 1~3位纯汉字 30 0.03 元
2004 1~4位纯汉字 40 0.04 元
2005 1~5位纯汉字 50 0.05 元
2006 1~6位纯汉字 60 0.06 元
2007 1~7位纯汉字 70 0.07 元
3004 1~4位纯英文 10 0.01 元
3005 1~5位纯英文 12 0.012 元
3006 1~6位纯英文 15 0.015 元
3007 1~7位纯英文 17.5 0.0175 元
3008 1~8位纯英文 20 0.02 元
3012 1~12位纯英文 30 0.03 元
4004 1~4位纯数字 10 0.01 元
4005 1~5位纯数字 12 0.012 元
4006 1~6位纯数字 15 0.015 元
4007 1~7位纯数字 17.5 0.0175 元
4008 1~8位纯数字 20 0.02 元
5000 不定长汉字英文数字 2.5/英文, 10/汉字(基础10) 每英文 0.0025 元、每汉字 0.01 元（基础 0.01 元）
5108 8位英文数字(含特殊字符) 22 0.022 元
5201 拼音首字母 / 计算题 / 成语混合 首字母20, 计算20, 成语40 首字母 0.02 元 / 计算 0.02 元 / 成语 0.04 元
6001 计算题(返回计算结果) 15 0.015 元
6004 问答题 / 智能回答题 15 0.015 元
6900 中英数混合(配合8f指令取特定色彩) 基础10 每英文 0.0025 元、每汉字 0.01 元（基础 0.01 元）
9602 水平拼图的两个坐标 36 0.036 元
9801 按指定字符定位(返回指定字坐标) 9/定位, 最低28 每定位 0.009 元（最低 0.028 元）
9800 文字定位(返回所有字及坐标) 6/定位, 最低28 每定位 0.006 元（最低 0.028 元）
9901 定位图上有且仅有的一个图形块中心点坐标 16 0.016 元
9902 定位图上有且仅有的两个图形块中心点坐标 24 0.024 元
9900 定位各种滑块 / 缺口 / 色块 8/定位+8 每定位 0.008 元 + 基础 0.008 元
9101 按操作提示返回固定1个坐标 16 0.016 元
9102 按操作提示返回固定2个坐标 24 0.024 元
9103 按操作提示返回固定3个坐标 32 0.032 元
9104 按操作提示返回固定4个坐标 40 0.04 元
9004 按操作提示返回1~4个坐标 40 0.04 元
9005 按操作提示返回1~5个坐标 48 0.048 元
9006 按操作提示返回1~6个坐标 56 0.056 元
9008 按操作提示返回1~8个坐标 72 0.072 元
9009 按操作提示返回1~9个坐标 80 0.08 元

超级鹰结果校验：平台会随识别结果返回 md5，本站按官方算法 md5("软件ID,软件KEY,图片ID,图片结果") 逐条核验，校验不通过会以 4xxxx 拒绝返回，避免结果被中途篡改。

超级鹰报错返分：识别结果确实错误时，可凭识别接口返回的 pic_id 调「报错返分」退回题分。官方限制：须在拿到 pic_id 后 3 分钟内、部分类型不支持；仅允许在确认结果错误时调用，对正确结果报错会被评估信用。

本服務需項目簽名。識別準確率受圖片質量與幹擾強度影響，建議對失敗結果做重試或人工兜底。

ddddocr 通用識別

Python ddddocr（本地模型） 需簽名

純本地模型識別，無第三方依賴回調。首次調用會加載模型、響應偏慢屬正常。

POST /api/ddddocr/ocr 累計調用 0 次

OCR 文字識別

識別圖片中的文字內容，返回識別文本；可返回概率、按顏色過濾等。

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

true 時返回 data={text, probability}；false 時 data 為文本

true 時對透明通道圖片做白底修復

選填：僅識別指定顏色文字，如 ["red","blue","green"]

選填：HSV 區間字典，需與 colors 配合使用

true 時使用 Beta 版 OCR 模型（對部分驗證碼更準）

  • 本服務需項目簽名；上傳文件時請求體為 multipart/form-data。
  • 文件字段與 URL/base64 字段至少提供一個；同時提供時文件優先。
POST /api/ddddocr/set-ranges 累計調用 0 次

設置 OCR 字符範圍

設置本次識別實例的字符範圍（預定義編號或自定義字符集）。

必填：預定義 0=數字/1=小寫/2=大寫/3=大小寫/4=小寫+數字/5=大寫+數字/6=大小寫+數字/7=默認；或自定義字符串，如 "0123456789"

選填：配合 Beta 模型使用

  • 注意：後端每次調用都會新建識別實例，此接口只對「該次調用」的實例生效，不會改變之後 /ocr 請求的字符集。
POST /api/ddddocr/detect 累計調用 0 次

目標檢測

檢測圖片中的目標位置，返回各目標的邊界框與置信度。

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

  • 文件字段與 URL/base64 字段至少提供一個；同時提供時文件優先。
POST /api/ddddocr/slide-match 累計調用 0 次

滑塊匹配（邊緣匹配法）

通過邊緣檢測匹配滑塊小圖在背景大圖中的缺口位置（算法一）。

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

選填：默認 false

  • 滑塊（slide_image / slide_image_url）與背景（bg_image / bg_image_url）各至少提供其一；同時提供時文件優先。
  • 成功返回 data={target_x, target_y}，即缺口左上角坐標。
POST /api/ddddocr/slide-comparison 累計調用 0 次

滑塊匹配（差異比較法）

直接比較滑塊圖與背景圖差異定位缺口（算法二）。

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

上傳本地圖片（頁面調試現支持真實文件上傳）

或填寫圖片 URL / base64（無需本地文件時使用）

  • 滑塊（slide_image / slide_image_url）與背景（bg_image / bg_image_url）各至少提供其一；同時提供時文件優先。
  • 成功返回 data={target_x, target_y}。
小影API · 通用 API 聚合服務