文档转图片

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

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

接口简介

文档转图片接口把Word、PPT、PDF等文档按页转换为150DPI高清PNG图片，单文件不超过20MB，处理速度约每页1秒；多页产物自动打包为一个压缩包，并给出转出页数与图片总大小。适合文档在线预览、档案缩略图展示与网页内容发布等场景。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

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

想把 Word、PPT、PDF 直接变成图片在网页或小程序里展示？本接口按页把文档渲染为 150DPI 高清 PNG 图片，多页自动打包 zip，异步任务、查询取回下载地址。

## 接口概述

文档转图片接口面向文档在线预览、分享展示与内容防复制等场景：通过公网 URL、Base64（data: 开头）或文件 ID 上传 Word、PPT、PDF 等文档，接口创建异步转换任务并立即返回 task_id；服务端以两步工艺先将文档渲染为 PDF，再按 150DPI 密度逐页输出白底 PNG 图片，单页文档产出一张图，多页文档每页一张并自动打包为 zip。完成后凭 task_id 或自定义 serialnumber 调用任务处理查询接口（POST /api/v1/taskresult）：多页时 output_dourl 为 zip 包下载地址、单页时为 PNG 图片地址，output_content 为各页图片地址合集，output_info 返回 page_count（页数）与 file_size（总大小）等明细。输入单文件不超过 20MB。

## 核心能力

1. **逐页出图**：文档每一页生成一张独立 PNG 图片，忠实还原原始版式。
2. **高清输出**：按 150DPI 密度渲染，白色背景、去除透明通道，适合屏幕展示。
3. **多格式输入**：支持 Word（docx/doc）、PDF、PPT（pptx/ppt）等常见文档格式。
4. **自动打包**：多页产物自动打包为 zip，一次下载全部图片。
5. **幂等提交**：可传 serialnumber 自定义编号，同编号重复提交直接返回原任务，不重复创建。

## 产品优势

- **接入简单**：文件参数自动识别 URL/Base64/文件 ID 三种形态，与平台其他任务类接口共用任务处理查询接口。
- **效果保真**：专业文档引擎两步渲染，图片效果与原文档保持一致。
- **稳定可靠**：异步队列加并发控制；失败任务经 output_msg 返回明确原因。
- **响应迅速**：提交阶段毫秒级返回，转换耗时与页数相关（每页约 1 秒参考）。
- **降本增效**：替代人工逐页截图，文档预览图、分享图生成全自动。

## 效果展示

一句话理解：它就像给文档的每一页「拍照」——出来的是一张张在任何设备上看起来都一样、且无法再编辑的高清页面图。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/notice.docx | 要转换的文档（Word/PPT/PDF 等）：公网 URL / data: 开头的 Base64 / fileid_ 开头的文件 ID，最大 20MB |
| serialnumber | notice-20261107-001 | 可选，自定义编号，用于幂等与关联查询 |

你会拿到的结果（凭 task_id 经 taskresult 查询，output_status=finish 时，本例为一份 2 页文档）：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 任务状态 | finish | `output_status`（not/processing/finish/fail） |
| zip 打包下载地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261107/ac559102837465120938.zip | `output_dourl`，多页时全部页图片打包 zip；单页时直接为 PNG 地址 |
| 各页图片地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261107/1_1762473602_a1b2c3d4e5f6.png,https://fujian.phpwc.com/pyapi/uploads/api/20261107/2_1762473602_f6e5d4c3b2a1.png | `output_content`，每页 PNG 的远程 URL，逗号分隔 |
| 图片页数 | 2 | `output_info.page_count`（单页产物时无此字段） |
| 存储文件名 | 1_1762473602_a1b2c3d4e5f6.png,2_1762473602_f6e5d4c3b2a1.png | `output_info.file_name`，逗号分隔，页号前缀便于排序 |
| 图片总大小 | 362420 | `output_info.file_size`（字节，全部页合计） |
| 任务耗时 | 6 | `output_time`（秒） |

API请求示例：

```
POST /api/v1/doc2image
file=https://example.com/demo/notice.docx&serialnumber=notice-20261107-001
```

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

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

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

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac559102837465120938",
    "serialnumber": "notice-20261107-001",
    "jk_mark": "doc2image",
    "output_status": "finish",
    "output_content": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/1_1762473602_a1b2c3d4e5f6.png,https://fujian.phpwc.com/pyapi/uploads/api/20261107/2_1762473602_f6e5d4c3b2a1.png",
    "output_dourl": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/ac559102837465120938.zip",
    "output_info": {
      "file_name": "1_1762473602_a1b2c3d4e5f6.png,2_1762473602_f6e5d4c3b2a1.png",
      "file_mime": "image/png",
      "file_size": 362420,
      "page_count": 2
    },
    "output_msg": "文档转图片任务完成，output_dourl 为临时下载地址，请尽快下载。",
    "output_time": 6
  }
}
```

解读：finish 时多页产物 output_dourl 为 zip 打包地址、output_content 逐页给出 PNG 地址（单页时两者均为该 PNG 地址，且 output_info 无 page_count）；fail 时 output_msg 给出失败原因。图片按 150DPI 渲染，请及时下载转存产物。

## 应用场景

- **在线预览**：网页、小程序中把文档渲染为页图展示，终端无需安装办公软件
- **分享展示**：报告、方案的关键页转成图片，便于社交与消息场景传播
- **内容防复制**：文档以图片形式展示，避免正文被直接复制与二次编辑
- **教学资料**：课件、讲义转图片后嵌入学习系统与题库
- **存证留档**：关键文档页图片化归档，固定展示效果备查

## 应用案例

- **知识付费平台**：课程资料展示前自动转换为逐页图片，学员在手机上流畅翻阅，同时避免资料原文外流，相关投诉明显减少。
- **企业 OA 系统**：公告发布后由后台提交转换任务，通过任务结果查询接口取回 zip 包解包入库，公告附件的在线预览不再依赖本地 Office 环境。

常见问题

Q：这个接口能做什么？

A：把 Word、PPT、PDF 等文档按页转换为高清 PNG 图片。提交后返回 task_id，转换异步完成，凭任务处理查询接口（taskresult）获取图片或 zip 包下载地址。

Q：多页文档如何返回？

A：每页生成一张 PNG：单页文档的 output_dourl 为图片地址；多页文档的 output_dourl 为全部图片的 zip 包地址，output_content 为各页图片地址合集（逗号分隔），output_info.page_count 为总页数。

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

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

Q：图片清晰度和文件大小限制？

A：按 150DPI 密度输出白底 PNG 图片；输入单文件最大 20MB，转换耗时与页数相关，可参考每页约 1 秒预估轮询节奏。

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

请求方式： POST

业务请求参数

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

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

响应参数

字段名	类型	说明
`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	全部页图片总大小（字节）
`page_count`	int	转出图片页数
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

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

请先登录后使用在线测试