# image_ocr

**Repository Path**: alenzhai/image_ocr

## Basic Information

- **Project Name**: image_ocr
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 阿里云OCR服务 - Spring Boot 项目

这是一个基于 Spring Boot 的阿里云 OCR（光学字符识别）服务对接项目，支持多种证件和文档的文字识别。

## 功能特性

- 通用文字识别
- 身份证识别
- 营业执照识别
- 银行卡识别
- 发票识别
- 表格识别

## 技术栈

- Spring Boot 3.2.0
- Java 17
- 阿里云 OCR SDK 20210707
- Maven

## 快速开始

### 1. 配置阿里云凭证

在 `application.yml` 中配置你的阿里云访问密钥：

```yaml
aliyun:
  ocr:
    access-key-id: your-access-key-id
    access-key-secret: your-access-key-secret
    region-id: cn-hangzhou
```

或者使用本地配置文件 `application-local.yml`（已添加到 .gitignore，不会提交到代码仓库）：

```bash
# 复制配置文件
cp src/main/resources/application.yml src/main/resources/application-local.yml
# 编辑 application-local.yml 填入您的密钥
```

然后使用本地配置运行：
```bash
mvn spring-boot:run -Dspring-boot.run.profiles=local
```

### 2. 构建项目

```bash
mvn clean package
```

### 3. 运行项目

```bash
mvn spring-boot:run
```

或者运行打包后的 jar：
```bash
java -jar target/aliyun-ocr-service-1.0.0.jar
```

## API 接口

### 上传图片文件识别

所有识别接口都支持 `multipart/form-data` 方式上传图片：

| 接口 | 说明 |
|------|------|
| `POST /api/v1/ocr/general` | 通用文字识别 |
| `POST /api/v1/ocr/idcard` | 身份证识别 |
| `POST /api/v1/ocr/business-license` | 营业执照识别 |
| `POST /api/v1/ocr/bankcard` | 银行卡识别 |
| `POST /api/v1/ocr/invoice` | 发票识别 |
| `POST /api/v1/ocr/table` | 表格识别 |

#### 请求示例

```bash
curl -X POST http://localhost:8080/api/v1/ocr/general \
  -F "file=@test.jpg"
```

### URL 识别

```bash
curl -X POST "http://localhost:8080/api/v1/ocr/recognize-url" \
  -d "url=https://example.com/image.jpg" \
  -d "type=GENERAL"
```

### Base64 识别

```bash
curl -X POST http://localhost:8080/api/v1/ocr/recognize-base64 \
  -H "Content-Type: application/json" \
  -d '{
    "ocrType": "GENERAL",
    "imageBase64": "base64encodedstring..."
  }'
```

## 响应格式

```json
{
  "success": true,
  "message": "识别成功",
  "requestId": "request-id-from-aliyun",
  "data": {
    "text": "识别出的完整文本",
    "structuredData": {
      "field1": "value1",
      "field2": "value2"
    },
    "textRegions": [
      {
        "text": "单行文本",
        "points": [
          {"x": 10, "y": 10},
          {"x": 100, "y": 10},
          {"x": 100, "y": 30},
          {"x": 10, "y": 30}
        ],
        "confidence": 95.5
      }
    ],
    "confidence": 90.0
  }
}
```

## 获取阿里云密钥

1. 登录 [阿里云控制台](https://www.aliyun.com/)
2. 进入 **访问控制 (RAM)** -> **AccessKey 管理**
3. 创建或查看 AccessKey ID 和 AccessKey Secret
4. 开通 OCR 服务：[视觉智能开放平台](https://vision.aliyun.com/)

## 注意事项

- 请妥善保管 AccessKey Secret，不要提交到代码仓库
- 生产环境建议使用阿里云 RAM 子账号，并仅授予最小权限
- 默认单文件大小限制为 10MB，可在 `application.yml` 中调整

## License

MIT