Files
ocr-server/src/ocr_server/app.py
T
zimoyin a7d4ff6454 feat: add enable_detection switch to skip text detection
enable_detection: false 跳过检测模型,直接把整图当一行文本送识别。
实测:单行图可正确识别;多行整图因识别模型固定缩放到高 48px 会返回空结果,已加告警。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-13 15:59:25 +08:00

178 lines
6.7 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import logging
from fastapi import FastAPI, File, HTTPException, UploadFile, status
from fastapi.responses import JSONResponse
from ocr_server.config import Settings
from ocr_server.fields import build_specs, extract_fields
from ocr_server.logging_setup import configure_logging
from ocr_server.ocr import OCRService
from ocr_server.schemas import ApiResponse, I2TData, I2TRequest
from ocr_server.storage import ImageStore, InvalidImage
from ocr_server.task_queue import OCRTaskQueue
logger = logging.getLogger("ocr_server.app")
def create_app(settings: Settings | None = None) -> FastAPI:
settings = settings or Settings()
configure_logging(settings.log_level)
store = ImageStore(settings)
field_specs = build_specs(settings.extract_fields)
field_separators = tuple(settings.extract_separators or (":", ":"))
def create_ocr() -> OCRService:
return OCRService(
lang=settings.lang,
device=settings.device,
model_dir=settings.model_dir,
det_model_name=settings.det_model_name,
rec_model_name=settings.rec_model_name,
text_det_limit_side_len=settings.text_det_limit_side_len,
text_det_limit_type=settings.text_det_limit_type,
text_det_thresh=settings.text_det_thresh,
text_det_box_thresh=settings.text_det_box_thresh,
text_det_unclip_ratio=settings.text_det_unclip_ratio,
text_rec_score_thresh=settings.text_rec_score_thresh,
text_recognition_batch_size=settings.text_recognition_batch_size,
cpu_threads=settings.cpu_threads_resolved,
enable_mkldnn=settings.enable_mkldnn,
enable_detection=settings.enable_detection,
return_word_box=settings.return_word_box,
)
tasks = OCRTaskQueue(create_ocr, worker_count=settings.ocr_workers)
app = FastAPI(title="OCR Server", version="0.1.0")
@app.get("/healthz", response_model=ApiResponse, tags=["system"])
def healthz() -> ApiResponse:
return ApiResponse(data={"status": "ok"})
@app.post(
"/api/v1/upload",
response_model=ApiResponse,
status_code=status.HTTP_201_CREATED,
tags=["ocr"],
)
async def upload(file: UploadFile = File(...)) -> ApiResponse:
if not file.filename:
raise HTTPException(status_code=400, detail="请提供图片文件名")
content = await file.read(settings.max_upload_bytes + 1)
if len(content) > settings.max_upload_bytes:
raise HTTPException(
status_code=status.HTTP_413_REQUEST_ENTITY_TOO_LARGE,
detail=f"图片大小不能超过 {settings.max_upload_mb} MB",
)
try:
uploaded = store.save(content, file.filename)
tasks.submit(uploaded.file_id, store.path_for(uploaded.file_id))
snapshot = tasks.snapshot(uploaded.file_id)
if snapshot is not None:
uploaded.status, uploaded.progress, uploaded.queue_position = snapshot[:3]
return ApiResponse(data=uploaded)
except InvalidImage as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc
@app.post("/api/v1/i2t", response_model=ApiResponse, tags=["ocr"])
def image_to_text(request: I2TRequest) -> ApiResponse:
snapshot = tasks.snapshot(request.file_id)
if snapshot is None:
raise HTTPException(status_code=404, detail="图片不存在或已过期")
(
status_value,
progress,
queue_position,
result,
error,
ocr_started_at,
ocr_finished_at,
ocr_elapsed_ms,
) = snapshot
if status_value == "queued":
return ApiResponse(
data=I2TData(
file_id=request.file_id,
status=status_value,
progress=progress,
queue_position=queue_position,
ocr_started_at=ocr_started_at,
ocr_finished_at=ocr_finished_at,
ocr_elapsed_ms=ocr_elapsed_ms,
)
)
if status_value == "processing":
return ApiResponse(
data=I2TData(
file_id=request.file_id,
status=status_value,
progress=progress,
ocr_started_at=ocr_started_at,
ocr_finished_at=ocr_finished_at,
ocr_elapsed_ms=ocr_elapsed_ms,
)
)
if status_value == "failed":
return ApiResponse(
data=I2TData(
file_id=request.file_id,
status=status_value,
progress=progress,
ocr_started_at=ocr_started_at,
ocr_finished_at=ocr_finished_at,
ocr_elapsed_ms=ocr_elapsed_ms,
error=error or "OCR 识别失败",
)
)
if result is None:
raise HTTPException(status_code=500, detail="OCR 结果为空")
filtered = OCRTaskQueue.filter_document(result, request.min_confidence)
extracted = (
extract_fields(
filtered.text,
field_specs,
field_separators,
rows=OCRTaskQueue.document_rows(filtered),
include_empty=settings.extract_include_empty,
)
if field_specs
else None
)
if field_specs:
# 默认不打 INFO 级日志:字段值里可能含姓名等敏感信息。
# 调 log_level: DEBUG 可以看到抽取明细,便于排查取值错乱。
logger.debug(
"字段抽取 file_id=%s min_confidence=%.2f 命中=%s 未命中=%s",
request.file_id,
request.min_confidence,
extracted,
[spec.name for spec in field_specs if spec.name not in (extracted or {})],
)
return ApiResponse(
data=I2TData(
file_id=request.file_id,
status="completed",
progress=100,
ocr_started_at=ocr_started_at,
ocr_finished_at=ocr_finished_at,
ocr_elapsed_ms=ocr_elapsed_ms,
result=filtered,
fields=extracted,
)
)
@app.exception_handler(413)
async def request_too_large(_, __) -> JSONResponse:
return JSONResponse(status_code=413, content={"detail": "请求体过大"})
return app
app = create_app()
if __name__ == "__main__":
import uvicorn
settings = Settings()
uvicorn.run(app, host=settings.host, port=settings.port)