能力
九件事，一个接口。
要 PDF 就调 PDF，要证件照就调证件照，接口是同一套，不用为一件小事再找一家服务商。
01
HTML / Markdown → PDF
用标准浏览器内核渲染，复杂排版不用自己拼。
02
模板填充
合同、通知、报表按模板批量出稿。
03
PDF 合并
多份附件合成一份，保持页码顺序。
04
PDF 拆分
按页或区间拆出，便于归档与分发。
05
文档水印
文字水印与角度、透明度可控。
06
文字提取
从 PDF 取回可检索文本，供入库与检索。
07
图片转换 / 压缩 / 缩放
统一处理上传素材，控制体积与尺寸。
08
图片水印
交付图自动打标，留痕可查。
09
证件照生成
按规格裁切、换底、输出可直接使用的照片。
异步任务
异步任务模型
文档渲染动辄好几秒，不能一直占着你的请求。提交完拿个任务号，轮询或者等回调都行。
- 统一任务结构，能力之间可替换
- 状态可查：排队、执行、完成、失败
- 结果产物有独立地址与过期策略
- 独立的投递与恢复进程，回调不丢
计量与账务
计费与对账
按次收钱不难，难的是并发时不超支、失败时能退。账务跟着任务走：预占、结算、失败释放。
- 提交时预占额度，避免并发超支
- 成功后结算，失败自动释放
- 整数微元记账，不用浮点数算钱
- 每笔流水可对账、可导出
实测
实测耗时
下面是实测的中位数，用来估容量。真跑起来要看机器和并发，不构成 SLA。
0.6–2秒
文档渲染（HTML → PDF）
0.2秒
PDF / 图片工具类能力
2.5秒
证件照生成
162项
后端自动化测试
技术规格
部署方式
- 当前版本
- v0.2.1
- 后端
- Django + DRF + Celery，PostgreSQL，Redis
- 渲染与处理
- Playwright / Chromium、pypdf、Pillow
- 前端控制台
- React + TypeScript + Vite + Ant Design
- 账务
- 预占-结算-释放，整数微元分账（micro_cny）
- 对外文档
- 能力清单、计费说明、FAQ、错误码
能力还在补，验收测试也在推。真要用在生产上，对接前先跟我们确认一句。