README.md

# MinerUapi - PDF Processing Serverless API

基于 magic-pdf 0.9.2 版本的 PDF 处理 Serverless API。

## 功能特性

- PDF文本提取和OCR处理
- 自动识别文本PDF和OCR PDF
- 支持混合模式PDF处理
- S3存储集成

## API 使用说明

### 请求格式

json
{
"pdf_bytes": "base64编码的PDF文件内容",
"lang": "zh", // 可选，默认"zh"
"layout_model": true, // 可选，默认true
"formula_enable": true, // 可选，默认true
"table_enable": true, // 可选，默认true
"is_debug": false // 可选，默认false
}

### 响应格式

成功响应：

json
{
    "status": "success",
    "data": {
        "_parse_type": "txt或ocr",
        "_version_name": "0.9.2",
        "_lang": "zh",
        // 其他PDF解析结果
    }
}

错误响应：

json
{
"status": "error",
"message": "错误信息"
}

## 环境变量要求

部署时需要配置以下环境变量：

- `S3_ACCESS_KEY`: S3访问密钥
- `S3_SECRET_KEY`: S3访问密钥密文
- `S3_ENDPOINT`: S3服务端点
- `S3_BUCKET`: S3存储桶名称

## Python调用示例

python
from huggingface_hub import InferenceClient
import base64
def process_pdf(pdf_path: str, hf_token: str):
# 创建客户端
client = InferenceClient(
model="kitjesen/MinerUapi", # 替换为您的模型ID
token=hf_token
)
# 读取并编码PDF
with open(pdf_path, 'rb') as f:
pdf_bytes = base64.b64encode(f.read()).decode()
# 发送请求
response = client.post(json={
"pdf_bytes": pdf_bytes,
"lang": "zh",
"layout_model": True,
"formula_enable": True,
"table_enable": True
})
return response
# 使用示例
try:
result = process_pdf("example.pdf", "your_hf_token")
if result["status"] == "success":
    print("解析类型:", result["data"]["_parse_type"])
    print("版本:", result["data"]["_version_name"])
else:
print("处理失败:", result["message"])
except Exception as e:
print(f"调用出错: {str(e)}")

## 注意事项

1. 文件限制：
   - PDF大小建议不超过10MB
   - 支持文本PDF和扫描PDF

2. 处理时间：
   - 文本PDF: 通常几秒内完成
   - OCR PDF: 可能需要较长时间

3. S3存储：
   - 确保配置的S3权限正确
   - 建议定期清理临时文件

4. 版本说明：
   - 当前使用 magic-pdf 0.9.2 版本
   - 建议定期检查版本更新