PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
在使用 OCR、版面分析、表格识别、PDF 转可搜索 PDF 或 PDF 转 OFD 之前,需要通过 CPDF_SetDocumentAIModel 设置 DocumentAI 模型路径。模型以模型包的形式提供:一个基础包和若干扩展包。每次调用 CPDF_SetDocumentAIModel 只加载该文件里包含的能力,并与已加载的能力合并,不会替换。
CPDF_SetDocumentAIModel 的第二个参数 gpu_id 用于指定 AI 模型使用的 GPU 编号,-1 表示不使用 GPU。
CSDKErrorCode code = CPDF_SetDocumentAIModel(CPDF_TEXT("path/documentai.model"), -1);
if (code != e_CErrSuccess) {
return code;
}所有模型包(含基础包)的下载地址:https://download.compdf.com/download/models
SDK 包内默认自带基础模型 documentai.model,使用默认配置无需额外下载。 需要更高精度的版本或扩展功能时,才需要额外下载对应的扩展模型包,放到您指定的目录,并通过 CPDF_SetDocumentAIModel 指定路径。
| 文件 | 大小 | 作用 | 获取方式 / 何时需要 |
|---|---|---|---|
documentai.model | 约 230 MB | 基础包:版面分析、表格识别(均衡档位)、全部基础 OCR 语言 | SDK 包内默认自带;使用任何 AI 功能(版面分析、OCR、表格识别)都需要 |
table_legacy.model | 约 270 MB | 表格扩展包:高精度档位所需的有线 / 无线表格检测等资源 | 需额外下载;仅在 table_recognition_accuracy 为 e_CHighAccuracy(高精度)时需要,使用默认的均衡档位不需要 |
ocr_server.model | 约 139 MB | 高精度 OCR 增强包,包含中文、英文、日文等多种语言 | 需额外下载;需要更高精度的 OCR 识别时 |
document_process.model | 约 37 MB | 文档方向分类与倾斜矫正 | 需额外下载;使用 enable_document_orientation_classification(方向识别)或 enable_document_dewarp(矫正)时需要 |
四个文件合计约 676 MB。不需要额外功能时无需下载任何扩展包:默认配置只使用 SDK 包内自带的 documentai.model。
所有模型包都通过同一个接口加载:
// 先加载基础包。
CPDF_SetDocumentAIModel(CPDF_TEXT("path/documentai.model"), -1);
// 需要时再加载扩展包,已加载的能力会保留。
CPDF_SetDocumentAIModel(CPDF_TEXT("path/table_legacy.model"), -1);
CPDF_SetDocumentAIModel(CPDF_TEXT("path/document_process.model"), -1);CPDF_ReleaseDocumentAIModel 会释放全部已加载的模型;之后再使用 AI 功能需要重新加载。e_CErrConverting。documentai.model 已是 4.3.0 配套的版本;额外下载的扩展包也请下载 4.3.0 对应的版本。documentai.model 不包含均衡档位所需的资源,而 4.3.0 沿用同一个文件名。如果您曾把旧版 documentai.model 拷贝到自己的部署目录或工程中,升级时请用 4.3.0 SDK 包内的新文件覆盖,不要沿用原来的同名文件。 旧模型加载失败会返回错误,不会自动回退到高精度档位。| 现象 | 可能原因 |
|---|---|
CPDF_SetDocumentAIModel 返回错误 | 路径错误;模型文件与 SDK 版本不配套;文件不完整(下载中断) |
选了 e_CHighAccuracy,表格结果与预期不同或效果变差 | 没有加载 table_legacy.model(表格已改用规则识别) |
转换时返回 e_CErrLicenseOCRPermissionDeny(29) | 授权不包含 OCR 权限,与模型无关 |
如果您的设备使用 Intel 处理器,可以额外部署 OpenVINO 加速包,以提升 OCR 等 AI 识别的速度。加速包部署成功后,SDK 在加载 DocumentAI 模型时会自动使用 OpenVINO 后端,无需修改代码,也无需任何额外设置。
onnxruntime 运行库所在的同一目录),然后照常调用 CPDF_SetDocumentAIModel 加载模型并执行转换。注意事项: