Pārlūkot izejas kodu

pdf_converter_v2: OpenAPI 为 /pdf_to_markdown 添加 tags 与 summary

何文松 3 nedēļas atpakaļ
vecāks
revīzija
ad58d687aa
1 mainītis faili ar 10 papildinājumiem un 1 dzēšanām
  1. 10 1
      pdf_converter_v2/api/main.py

+ 10 - 1
pdf_converter_v2/api/main.py

@@ -730,7 +730,16 @@ async def convert_file(
     )
 
 
-@app.post("/pdf_to_markdown")
+@app.post(
+    "/pdf_to_markdown",
+    tags=["PDF转Markdown"],
+    summary="PDF/图片转 Markdown(同步)",
+    responses={
+        200: {"description": "format=file 时返回 .md 文件;format=json 时返回 JSON { markdown, filename }"},
+        400: {"description": "文件页数超过 20 页"},
+        500: {"description": "转换失败"},
+    },
+)
 async def pdf_to_markdown(
     file: Annotated[UploadFile, File(description="上传的 PDF 或图片文件")],
     backend: Annotated[