PDF 转 Image API
将 PDF 页面转换为图片。ComPDF Web 门面默认使用 PNG；直接转档接口也支持 jpg 和 jpeg target 值。
功能说明
ComPDF Self-hosted 提供同步文件流响应。该功能可以通过 ComPDF 请求地址调用，也可以直接调用转档接口。
调用方式
| 项目 | 值 |
|---|---|
| 认证 | x-api-key: your_api_key_here |
| 请求地址 | POST http://localhost:8080/api/v1/process/pdf/png |
| 请求类型 | multipart/form-data |
| 成功响应 | PNG or image archive 文件流 |
请求参数
| 参数名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
file | File | 源文件，建议扩展名：.pdf。 | 是 |
options | String | JSON 字符串，包含下方功能参数。 | 否 |
password | String | 源文件打开密码，适用于受密码保护的 PDF。 | 否 |
Options 参数
以下字段放入 options JSON 字符串中。ComPDF Self-hosted 会解析 JSON，并在转发给转换引擎前做少量规范化。
| 参数名 | 类型 | 作用 |
|---|---|---|
imageFormat | String | 输出图片格式。支持 JPG、JPEG、JPEG2000、PNG、BMP、TIFF、TGA、GIF、WEBP。ComPDF Self-hosted 转发前会将该值转为大写。 |
imageScaling | Number | PDF 转图片时的图像缩放比例。ComPDF Web 会按 DPI / 72 计算该值。 |
pageRanges | String | 需要处理的页码范围，从 1 开始。示例：1、1-3、1,3-5。为空表示全部页面。 |
outputFileName | String | 可选输出文件名。传入后会作为首选下载文件名。 |
请求示例
bash
curl -X POST "http://localhost:8080/api/v1/process/pdf/png" \
-H "x-api-key: your_api_key_here" \
-F "[email protected]" \
-F 'options={"imageFormat":"PNG","imageScaling":2,"pageRanges":""}'响应
成功时返回转换后的文件流，响应头包含 Content-Type 和 Content-Disposition。如果转换失败，ComPDF Self-hosted 会返回统一错误 JSON。