# CaptchaOCR

**Repository Path**: yinxiaoxing/captcha-ocr

## Basic Information

- **Project Name**: CaptchaOCR
- **Description**: 本项目是一个基于 ddddocr 的验证码识别服务，提供通过 Base64 编码 和 图片 URL 两种方式识别验证码的功能，并封装为一个 Web API 接口。主要适用于需要自动识别验证码的场景，例如自动化测试、爬虫等。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-06
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CaptchaOCR 项目说明

本项目是一个基于 `ddddocr` 的验证码识别服务，提供通过 **Base64 编码** 和 **图片 URL** 两种方式识别验证码的功能，并封装为一个 Web API 接口。主要适用于需要自动识别验证码的场景，例如自动化测试、爬虫等。

## 🧩 功能特性

- ✅ 支持 Base64 编码图片识别
- ✅ 支持远程 URL 图片下载并识别
- ✅ 提供 RESTful API 接口服务（FastAPI / Flask）
- ✅ 支持调试日志输出，便于排查问题

## 📦 技术栈与依赖

```plaintext
ddddocr
fastapi (或 flask)
uvicorn (用于运行 FastAPI)
requests
base64
```


请确保已安装上述依赖库。可使用以下命令安装：

```bash
pip install ddddocr fastapi uvicorn requests
```


如使用 Flask 版本，则替换为：

```bash
pip install ddddocr flask requests
```


## 📁 项目目录结构

```
.
├── README.md               # 项目说明文档
├── app.py                  # FastAPI 主程序，提供接口服务
└── main.py                 # 核心识别逻辑模块
```


## 🚀 快速启动

### 启动服务（FastAPI）

```bash
python app.py
```


服务将运行在 `http://127.0.0.1:5000`，可通过如下接口访问：

| 接口名称 | 方法 | 路径 |
|----------|------|------|
| Base64 验证码识别 | POST | `/recognize_captcha_base64` |
| URL 验证码识别 | POST | `/recognize_captcha_image_url` |

### 请求参数说明

#### Base64 请求体（JSON）

```json
{
  "uuid": "唯一标识",
  "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAAA..."
}
```


#### URL 请求体（JSON）

```json
{
  "uuid": "唯一标识",
  "image_url": "https://example.com/captcha.jpg"
}
```


### 返回值示例

```json
{
  "code": 200,
  "data": "ABCD1234",
  "uuid": "唯一标识"
}
```


## 🛠️ 使用说明

- `main.py` 中封装了核心验证码识别函数：`recognize_captcha_base64()` 和 `recognize_captcha_url()`。
- `app.py` 提供了对外服务接口。
- `util.js` 提供了一个前端请求示例，可用于浏览器中调用后端接口识别 Blob URL 验证码。

## 📌 注意事项

- 确保网络环境允许访问外部图片 URL。
- 如需部署，请考虑添加身份验证机制和并发处理支持。
- 日志信息会输出到控制台，便于调试。

---

参阅：https://github.com/sml2h3/ddddocr

---