PDF转文档

接口标识: pdf2word 价格: 0.01 元/次 VIP免费异步响应

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

接口简介

PDF转文档接口把PDF文件转换成可编辑的Word文档，输出格式可选docx或doc（默认docx），单文件不超过20MB。转换中文字、图片与版式自动还原，产物可直接编辑、二次排版与内容复用，处理速度约每页1秒。适合合同模板二次编辑、报告材料改稿与版式文件的内容再利用。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

![PDF转文档接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_pdf2word__1794166691_2890458be69a.png)

收到 PDF 合同、方案想再编辑？本接口把 PDF 文件转换为可编辑的 Word 文档（docx/doc），文字、图片与版式自动还原，提交即返回任务号，结果异步查询获取。

## 接口概述

PDF转文档接口面向文档编辑、合同修订、档案电子化等办公自动化场景：通过公网 URL、Base64（data: 开头）或文件 ID 上传 PDF 文件，接口创建异步转换任务并立即返回 task_id；转换引擎解析 PDF 的文字、图片与版式结构，重建为可编辑的 Word 文档，可用 output_type 参数选择输出 docx（默认）或 doc 格式。转换完成后，凭 task_id 或自定义 serialnumber 调用平台的任务处理查询接口（POST /api/v1/taskresult），output_status 为 finish 时 output_dourl 即转换后文档的下载地址。输入单文件不超过 20MB，转换耗时与页数相关（每页约 1 秒参考）。

## 核心能力

1. **PDF转Word**：解析 PDF 文字、图片与版式，重建为可编辑的 docx 文档。
2. **双格式输出**：output_type 支持 docx（默认）与 doc，适配新旧 Office 版本。
3. **异步任务**：提交立即返回 task_id，不阻塞调用方线程，适合大文件与批量提交。
4. **幂等提交**：可传 serialnumber 自定义编号，同编号重复提交直接返回原任务，不重复创建。
5. **结果可查**：转换状态与产物地址经任务处理查询接口统一获取，也支持按自定义编号查询。

## 产品优势

- **接入简单**：标准 POST + JSON，文件参数自动识别 URL/Base64/文件 ID 三种形态，查询接口与平台其他任务类接口通用。
- **版式还原**：转换引擎基于 PDF 内部结构提取重建，文字、图片、表格尽量保持原有排版。
- **稳定可靠**：异步队列加并发控制，服务端负载均匀；失败任务经 output_msg 返回明确原因。
- **响应迅速**：提交阶段毫秒级返回，转换在后台完成，耗时与页数相关（每页约 1 秒参考）。
- **降本增效**：替代人工逐段重录与手动转换操作，文档处理流程自动化。

## 效果展示

一句话理解：它就像把 PDF 交给「排版师」重新排一遍——原来锁死的版式，变成能编辑、能修改的 Word。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/contract.pdf | 要转换的 PDF：公网 URL / data: 开头的 Base64 / fileid_ 开头的文件 ID，最大 20MB |
| output_type | docx | 可选，输出格式 docx（默认）或 doc |
| serialnumber | order-20261107-001 | 可选，自定义编号，用于幂等与关联查询 |

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

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 任务状态 | finish | `output_status`（not/processing/finish/fail） |
| Word 文档下载地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261107/1762473601_9f3a2b1c4d5e.docx | `output_dourl`，临时地址，请及时下载转存 |
| 产物 URL 回显 | 与 output_dourl 同值 | `output_content`，单文件产物时与下载地址一致 |
| 存储文件名 | 1762473601_9f3a2b1c4d5e.docx | `output_info.file_name`，平台生成的产物文件名（非原文件名） |
| 文件大小 | 245760 | `output_info.file_size`（字节） |
| 任务耗时 | 8 | `output_time`（秒） |

API请求示例：

```
POST /api/v1/pdf2word
file=https://example.com/demo/contract.pdf&output_type=docx&serialnumber=order-20261107-001
```

提交后返回 task_id，凭它调用任务查询接口轮询，output_status=finish 即拿到异步结果：

```
POST /api/v1/taskresult
task_id=ac812304976543210987
```

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

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac812304976543210987",
    "serialnumber": "order-20261107-001",
    "jk_mark": "pdf2word",
    "output_status": "finish",
    "output_content": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/1762473601_9f3a2b1c4d5e.docx",
    "output_dourl": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/1762473601_9f3a2b1c4d5e.docx",
    "output_info": {
      "file_name": "1762473601_9f3a2b1c4d5e.docx",
      "file_mime": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "file_size": 245760
    },
    "output_msg": "PDF转文档任务完成，output_dourl 为临时下载地址，请尽快下载。",
    "output_time": 8
  }
}
```

解读：finish 时 output_dourl 即转换后 Word 文档的下载地址，属临时地址请及时下载转存；fail 时 output_msg 给出失败原因。

## 应用场景

- **合同管理**：对方发来的 PDF 合同转为 Word，便于修订条款与重新拟稿
- **档案电子化**：历史纸质档案的扫描 PDF 批量转为可编辑文档入库
- **学术编辑**：文献、论文 PDF 转 Word 后进行摘录与批注
- **办公自动化**：OA/ERP 流程中附件 PDF 自动转可编辑格式再流转
- **模板复用**：把 PDF 模板还原为 Word，修改后再次下发使用

## 应用案例

- **律师事务所**：收到对方发来的合同 PDF 后，过去需要人工重录可修订版本；接入接口后自动批量转为 Word 再修订条款，单份合同的处理时间明显缩短。
- **企业行政部门**：档案电子化项目中用定时任务提交扫描 PDF 转换，通过任务结果查询接口取回 docx 下载地址自动归档，建成可全文检索的电子档案库。

常见问题

Q：这个接口能做什么？

A：把 PDF 文件转换为可编辑的 Word 文档。提交后返回 task_id，转换异步完成，凭任务处理查询接口（taskresult）获取产物下载地址。

Q：支持哪些输出格式？

A：output_type 参数支持 docx（默认）与 doc 两种格式，doc 由 docx 二次转换生成，适配旧版 Office。

Q：异步调用流程是怎样的？

A：调用本接口提交文件获得 task_id（或使用自己传入的 serialnumber），随后轮询任务处理查询接口（POST /api/v1/taskresult）；output_status=finish 时 output_dourl 即转换后文档下载地址，fail 时 output_msg 给出失败原因。

Q：文件大小有什么限制？

A：单文件最大 20MB，超限会返回错误提示；转换耗时与页数相关，可参考每页约 1 秒预估轮询节奏。

PDF转Word PDF转换文档转换 docx doc 异步任务办公自动化

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`serialnumber`	string	选填	-	开发者自定义查询编号，同接口下不可重复，用于幂等和关联查询
`output_type`	string	选填	`docx`	输出文件类型，支持: docx/doc，默认值: docx

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`task_id`	string	任务ID，用于通过 taskresult 接口查询任务结果
`serialnumber`	string	调用方传入的 serialnumber，用于通过 taskresult 接口查询任务结果
`task_msg`	string	预计任务耗时：每页约1秒
`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	任务明细数据
`file_size`	int	转换后文件大小（字节）
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

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

请先登录后使用在线测试