72 lines
1.2 KiB
Markdown
72 lines
1.2 KiB
Markdown
# fastapi-vision-ocr
|
||
|
||
一个更轻的 macOS OCR API 示例：
|
||
|
||
- `FastAPI` 提供 HTTP 接口
|
||
- `pyobjc-framework-Vision` 直接调用 `VNRecognizeTextRequest`
|
||
- 接收 `multipart/form-data` 图片上传
|
||
|
||
## 要求
|
||
|
||
- macOS
|
||
- Python 3.11+
|
||
- Xcode Command Line Tools
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
cd /Users/amy/Documents/workspace/ecommer-codebase/fastapi-vision-ocr
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## 启动
|
||
|
||
```bash
|
||
cd /Users/amy/Documents/workspace/ecommer-codebase/fastapi-vision-ocr
|
||
source .venv/bin/activate
|
||
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||
```
|
||
|
||
## 测试
|
||
|
||
健康检查：
|
||
|
||
```bash
|
||
curl http://127.0.0.1:8000/health
|
||
```
|
||
|
||
OCR：
|
||
|
||
```bash
|
||
curl -X POST http://127.0.0.1:8000/ocr \
|
||
-F "image=@/absolute/path/to/test.png" \
|
||
-F "recognition_level=accurate" \
|
||
-F "languages=zh-Hans" \
|
||
-F "languages=en-US"
|
||
```
|
||
|
||
返回：
|
||
|
||
```json
|
||
{
|
||
"text": "hello\nworld",
|
||
"lines": [
|
||
{
|
||
"text": "hello",
|
||
"confidence": 0.99
|
||
},
|
||
{
|
||
"text": "world",
|
||
"confidence": 0.98
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 说明
|
||
|
||
- 这个服务只适合跑在 macOS，因为底层依赖 Apple Vision.framework。
|
||
- 这是 MVP 方案，目标是先把“上传图片返回文本”快速跑通。
|