{"service":"PaddleOCR GPU Worker","version":"1.0.0","gitCommit":"aac7cd7","schemaCompat":"research-pipeline-paddleocr-v1","說明":"CUDA 13 / PaddlePaddle GPU 版 OCR 與文件解析服務；/parse 是 research pipeline 主線相容 API。","文件":{"Swagger UI":"/docs","OpenAPI JSON":"/openapi.json"},"併發":{"中文說明":"admission 上限 4 個並發請求，超過者排隊；排隊逾時回 503 server-busy（retryable=true）。","maxConcurrency":4},"錯誤格式":{"中文說明":"所有 gateway 層錯誤回傳 {\"error\": {\"code\", \"message\", \"retryable\", \"requestId\"}}；caller 可依 retryable 決定重試。","codes":["server-busy","payload-too-large","pipeline-error","render-error"]},"apis":[{"method":"GET","path":"/","中文說明":"顯示 API 清單與簡短用途說明。"},{"method":"GET","path":"/health","中文說明":"健康檢查；確認 PaddlePaddle、CUDA、GPU 與基本 GPU 運算是否正常，並回報 build 版本與併發設定。"},{"method":"POST","path":"/parse","中文說明":"研究報告 pipeline 主線相容介面；接受完整 PDF 或單頁圖片，內部使用 PPStructureV3，回傳 research-pipeline-paddleocr-v1 schema：pages、pageNumber、width/height、blocks/bbox/layoutType/readingOrder、tables/html/cells。","formData":["file","pageNumber（單頁圖片時可指定；完整 PDF 通常省略）"],"productionUsage":"主線 pipeline 使用此 endpoint；不要直接依賴 /parse/structure-v3 raw schema。"},{"method":"POST","path":"/parse/vl","中文說明":"PaddleOCR-VL v1.6 full pipeline gateway；接受完整 PDF 或單頁圖片，回傳同一個 research-pipeline-paddleocr-v1 compatibility schema。","formData":["file","pageNumber（單頁圖片時可指定；完整 PDF 通常省略）"],"productionUsage":"VL rollout 時 business pipeline 將 PADDLEOCR_ENDPOINT 指向此 endpoint；不要直接呼叫 8118 /v1。"},{"method":"POST","path":"/ocr/v5","中文說明":"一般 PP-OCR 單圖 OCR（模型由 PADDLEOCR_TEXT_*_MODEL_NAME 決定，預設 PP-OCRv6_medium；路徑名稱為歷史相容保留）；回傳 PaddleOCR OCR 原始 JSON 結果。","formData":["file"]},{"method":"POST","path":"/ocr/liteparse","中文說明":"LiteParse v2（pi-docparser）HTTP OCR 契約轉接層；multipart file+language 上傳單圖，內部沿用同一個 PP-OCR pipeline（預設 PP-OCRv6_medium），回傳 {results:[{text,bbox,confidence,polygon}]}；language 僅記錄不生效。","formData":["file","language（僅記錄；實際語言由 PADDLEOCR_LANG 固定）"]},{"method":"POST","path":"/parse/structure-v3","中文說明":"PPStructureV3 原始解析介面；回傳 PaddleOCR LayoutParsingResult 原始 JSON，僅供除錯、fidelity audit、schema normalizer 開發使用，不作為 production pipeline fallback。","formData":["file"]},{"method":"GET","path":"/demo","中文說明":"瀏覽器視覺化 demo：上傳 PDF/圖片後將 /parse 或 /parse/vl 的 blocks/tables 依 type 以彩色框疊在頁面影像上，含圖例、閱讀順序與逐 block 文字。"},{"method":"POST","path":"/render","中文說明":"將 PDF 逐頁（或圖片）轉成 PNG base64，供 /demo 當疊框底圖；純 CPU 轉檔，僅 demo/debug 用。","formData":["file","maxPages（預設 50，上限 100）"]}]}