{"name":"OCR Microservice","version":"2.0.0","description":"REST API for document OCR using vision LLMs (llama.cpp) with PDF Inspector integration","docs":"/docs","redoc":"/redoc","openapi":"/openapi.json","health":"/ocr/health","endpoints":{"synchronous":{"POST /ocr":"Process document via base64 JSON (requires API key)","POST /ocr/image":"Process document via base64 JSON (alias)","POST /ocr/pdf":"Process document via multipart form-data (requires API key)","POST /ocr/hybrid":"Hybrid OCR pipeline with PaddleOCR + Gemma4 (requires API key)","POST /ocr/inspector":"Intelligent OCR with PDF Inspector routing (requires API key)"},"asynchronous":{"POST /ocr/async/pdf":"Submit async job for background processing (requires API key)","GET /ocr/jobs/{job_id}":"Get async job status/result (public)"},"public":{"GET /ocr/health":"Health check and service status","GET /ocr/models":"List available LLM models","GET /":"API information and documentation links"}},"authentication":{"type":"API Key (X-API-Key header)","required_endpoints":["/ocr","/ocr/image","/ocr/pdf","/ocr/async/pdf","/ocr/hybrid","/ocr/inspector"],"public_endpoints":["/ocr/health","/ocr/models","/ocr/jobs/{job_id}","/","/docs","/redoc","/openapi.json"],"management":{"tool":"manage_keys.py CLI","create":"python manage_keys.py create --name 'My App' --rate-limit 60","list":"python manage_keys.py list","stats":"python manage_keys.py stats <key_id>","revoke":"python manage_keys.py revoke <key_id>"}},"features":{"ocr_pipeline":"PaddleOCR + Gemma4 with validation and feedback loop","pdf_inspector":"Smart routing for text-based vs scanned PDFs","multi_page":"Handles documents with multiple pages","async_processing":"Background job queue for large documents","validation":"Automatic validation of extracted data (CUPS, NIF, IBAN, etc.)","rate_limiting":"Configurable per API key (default: 60 req/min)"},"supported_formats":["PDF","PNG","JPEG","TIFF","BMP","WebP"],"supported_doc_types":["general","contrato","table","handwriting","scan"],"models":{"default":"gemma4:latest","llama_api":"http://cos-alicante.netbird.vpn:8080","ollama_api_fallback":"http://cos-alicante.netbird.vpn:11434/api/chat"},"logging":{"enabled":true,"level":"DEBUG","directory":"logs","request_id_header":"X-Request-ID"},"repository":"https://github.com/eztornado/ocr.reigreengroup.com","license":"MIT"}