a7d4ff6454
enable_detection: false 跳过检测模型,直接把整图当一行文本送识别。 实测:单行图可正确识别;多行整图因识别模型固定缩放到高 48px 会返回空结果,已加告警。 Co-Authored-By: Claude Code <noreply@anthropic.com>
178 lines
6.7 KiB
Python
178 lines
6.7 KiB
Python
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)
|