PDF 压缩

接口标识: pdfcompress 价格: 0.5 元/次异步响应

接口介绍
接口文档
在线测试

接口简介

PDF 压缩接口在保持页面内容完整的前提下缩小 PDF 体积，三档力度可选：low 只做无损整理不动图片；medium 把过大图片降采样至约 1500 像素；high 降至约 800 像素，适合扫描件与图册。压缩保证不增大体积，降采样无收益时自动回退无损档；文字层不受影响，压缩后文字仍可选中复制。单文件不超过 200MB，返回压缩前后体积与压缩率明细，适合邮件附件瘦身、系统上传达标与档案入库省存储等场景。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

![PDF 压缩接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_pdfcompress__1794363376_4fdf6095931e.png)

扫描版合同、图册型报告越做越大，邮件附件超限、系统上传被拦。PDF 压缩接口在保住文字与页面内容的同时给文件瘦身，三档力度可选。

## 接口概述
面向 PDF 体积需要压缩后才能传输、归档或上传的场景，传入一份 PDF（公网 URL、Base64 或平台文件 ID，不超过 200MB）并指定压缩档位，接口在保持页面内容完整的前提下输出更小的文件。本接口为异步任务接口：提交后返回 task_id，凭它调用 taskresult 接口查询结果；任务完成后返回压缩后文件的下载地址与原体积、压缩后体积、压缩率等明细。文字层全程不受影响，压缩后文字仍可选中复制，适合文档交付、档案入库与上传前置处理等流程集成。

## 核心能力
1. **三档压缩**：low 只做无损整理不动图片；medium 把过大图片降采样至约 1500 像素；high 降至约 800 像素，扫描件、图册适用。
2. **只减不增**：medium/high 同时生成无损与降采样两个版本、自动取更小者，降采样没有收益时回退无损档，体积保证不增大。
3. **文字保全**：不做整页转图，文字层原样保留，压缩后文字仍可选中、复制与检索。
4. **明细回执**：返回原体积、压缩后体积、压缩率与实际降采样的图片数，效果一目了然。

## 产品优势
1. **接入简单**：提交任务与查询结果都走平台统一的任务接口，无需自建回调服务。
2. **安全优先**：无损优先策略，宁可少压也不破坏画质，文字与页面结构原样保留。
3. **稳定可靠**：加密 PDF、损坏文件返回明确错误，任务状态全程可查。
4. **准确规范**：各档位的图片处理强度固定透明，批量处理效果一致。
5. **降本增效**：邮件附件、系统上传、云端存档都因体积瘦身而顺畅，带宽与存储双省。
6. **生态开放**：可与平台 PDF 拆分、提取等接口串联，先拆分再分别压缩交付。

## 效果展示
一句话理解：它就像给行李抽真空——衣服（页面内容）原样都在，空气（冗余体积）被抽走，箱子小了一圈。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/album.pdf | 要压缩的 PDF，公网 URL、Base64 或文件 ID，≤200MB |
| level | high | 压缩档位：low 无损整理 / medium 图片约 1500 像素 / high 约 800 像素，默认 medium |
| serialnumber | press-20261112-001 | 自定义查询编号，同接口下不可重复，用于幂等与对账 |

你会拿到的结果（凭 task_id 经 taskresult 查询、output_status=finish 时）：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 压缩后文件地址 | `https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_3c942a375f4a.pdf` | `output_content` 与 `output_dourl` 同值，即压缩后 PDF 的地址 |
| 体积变化 | 18874368 → 4194304 | `output_info` 的 original_size、compressed_size，单位字节 |
| 压缩率 | 0.7778 | `output_info` 的 ratio，表示体积减少约 77.78% |
| 任务状态 | `"finish"` | `output_status`，finish 完成、fail 失败并给出原因 |

API请求示例：

```text
POST /api/pdfcompress
file=https://example.com/demo/album.pdf&level=high&serialnumber=press-20261112-001
```

提交后拿到 task_id，轮询 taskresult 接口查询，任务完成后得到如下最终结果：

API响应示例（taskresult 查回的最终异步结果）：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac7m2q9x4p1z6r8t3w5y0k",
    "serialnumber": "press-20261112-001",
    "jk_mark": "pdfcompress",
    "output_status": "finish",
    "output_content": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_3c942a375f4a.pdf",
    "output_dourl": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/1762915800_3c942a375f4a.pdf",
    "output_info": {
      "file_name": "1762915800_3c942a375f4a.pdf",
      "file_mime": "application/pdf",
      "original_size": 18874368,
      "compressed_size": 4194304,
      "ratio": 0.7778,
      "level": "high",
      "image_count_downsampled": 36
    },
    "output_msg": "处理完成",
    "output_time": 12
  },
  "request_id": "pdfcompress-demo-001"
}
```

这次调用把 18MB 的图册型 PDF 用 high 档压到 4MB，36 张超大图片被降采样；ratio 0.7778 表示体积减少约 77.78%，文档文字照常可以选中复制。

## 应用场景
1. **邮件交付**：合同、报告附件超限，压缩到邮箱限制以内再发送。
2. **系统上传**：政务、集团系统对文件体积设限，上传前统一预处理。
3. **网站文档**：官网可下载的产品手册、白皮书瘦身，用户下载更快。
4. **档案入库**：历史文档批量压缩后归档，节省云存储与备份开销。
5. **移动分发**：产品图册发给销售团队手机端，省流量也省存储空间。

## 应用案例
一家外贸公司的业务员常要把 20MB 以上的产品图册发给海外客户，邮箱屡次拒收；接入接口后，客户管理系统发信前自动用 high 档压缩图册，图片清晰度仍够客户看清产品细节，退信基本消失。

某招投标平台的运维负责人每月要归档数百 MB 的投标附件，存储成本逐年上涨；现在附件统一先走 medium 档压缩再入库，页面内容一件不少，存储占用明显下降。

一个研究机构的内刊编辑要把报告发布到自有客户端供会员阅读，大文件下载慢、投诉多；改用接口压缩后发布，体积大幅减小，文字仍可选中引用，会员阅读体验明显改善。

常见问题

Q：压缩会不会让图片变糊、文字丢失？

A：low 档完全不动图片；medium/high 只对超过阈值的图片降采样，且文字层全程保留，压缩后文字仍可选中、复制与检索。

Q：压缩后文件反而变大怎么办？

A：不会出现。medium/high 会同时生成无损与降采样两个版本并自动取更小者，降采样没有收益时回退无损档，接口保证体积不增大。

Q：提交任务后怎么拿结果？

A：提交返回 task_id，凭它调用 taskresult 查询：output_status 为 finish 时，output_dourl 是压缩后 PDF 的地址，output_info 里有原体积、压缩后体积、压缩率与降采样图片数。

Q：三档压缩力度怎么选？

A：以文字为主的文档用 low 无损整理即可；图文混排用默认的 medium；扫描件、图册类用 high，图片会降到约 800 像素换取更小体积。

PDF压缩文件瘦身体积减小办公工具 PDF工具

接口地址： https://www.phpwc.cn/api/pdfcompress

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	PDF 文件，三形态，≤200MB。文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`level`	string	选填	`medium`	压缩档位：low（无损整理，对象流压缩）/ medium（图片降采样至约1500px）/ high（约800px，扫描件适用），默认 medium
`target_size_kb`	int	选填	-	目标体积（KB，尽力而为，不保证精确命中）
`serialnumber`	string	选填	-	开发者自定义查询编号，同接口下不可重复，用于幂等和关联查询

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`task_id`	string	任务ID，用于通过 taskresult 接口查询任务结果
`serialnumber`	string	调用方传入的 serialnumber，用于通过 taskresult 接口查询任务结果
`task_msg`	string	任务提示信息（含预计耗时），随后经 taskresult 查询结果
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

异步响应字段（调用 taskresult 返回）

本接口为异步任务类：提交后立即返回 task_id，需再调用 taskresult（传 task_id 或 serialnumber）查询结果，返回字段如下。

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	任务结果数据
`task_id`	string	任务ID（与提交响应一致）
`serialnumber`	string	调用方传入的 serialnumber（未传则为空串）
`jk_mark`	string	原调用接口标识
`output_status`	string	任务状态：not=未开始 / processing=处理中 / finish=完成 / fail=失败
`output_content`	string	完成后的文本结果（如翻译全文、问答答案），无则为空串
`output_dourl`	string	完成后的产物下载地址（图片/文档/音视频），无则为空串
`output_info`	object	任务明细数据（随接口不同，见子字段）
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

{
  "code": 0,
  "desc": "success",
  "data": {
    "task_id": "任务ID",
    "serialnumber": "调用方传入的流水号",
    "jk_mark": "pdfcompress",
    "output_status": "finish",
    "output_content": "文本结果（无则空）",
    "output_dourl": "产物下载地址（无则空）",
    "output_info": { },
    "output_msg": "任务完成提示",
    "output_time": 12
  },
  "request_id": "abc123..."
}

请先登录后使用在线测试