文档转HTML-追梦API

文档转HTML

/api/v1/html 1 积分/次（约 ¥0.05/次）运行中

文档转HTML

请求示例

request

CURL Python Node.js

curl -X POST https://api.zhuimengapi.com/api/v1/html \
  -H "X-API-Key: RPA-xxxxxxxx"
  -H "Content-Type: application/json"
  -d '{
    "url": "公网可访问的文档 URL。支持的输入格式：ppt、doc、xls、pdf、txt、rtf、html 等，单文件 ≤200MB、≤5000 页",
    "expire": 0,
    "title": "预览 HTML 标题，不传默认\"追梦网络-文档预览服务\"",
    "copyable": "\"0\" 不可复制，\"1\" 可复制，默认可复制",
    "waterword": "水印文字，明文，服务端自动做 URL 安全 Base64"
}'

import requests

url = "https://api.zhuimengapi.com/api/v1/html"
headers = {"X-API-Key": "RPA-xxxxxxxx", "Content-Type": "application/json"}
data = {
    "url": "公网可访问的文档 URL。支持的输入格式：ppt、doc、xls、pdf、txt、rtf、html 等，单文件 ≤200MB、≤5000 页",
    "expire": 0,
    "title": "预览 HTML 标题，不传默认\"追梦网络-文档预览服务\"",
    "copyable": "\"0\" 不可复制，\"1\" 可复制，默认可复制",
    "waterword": "水印文字，明文，服务端自动做 URL 安全 Base64"
}

res = requests.post(url, json=data, headers=headers)
print(res.json())

const axios = require('axios');

axios.post("https://api.zhuimengapi.com/api/v1/html", {
    "url": "公网可访问的文档 URL。支持的输入格式：ppt、doc、xls、pdf、txt、rtf、html 等，单文件 ≤200MB、≤5000 页",
    "expire": 0,
    "title": "预览 HTML 标题，不传默认\"追梦网络-文档预览服务\"",
    "copyable": "\"0\" 不可复制，\"1\" 可复制，默认可复制",
    "waterword": "水印文字，明文，服务端自动做 URL 安全 Base64"
}, {
  headers: { "X-API-Key": "RPA-xxxxxxxx", "Content-Type": "application/json" }
}).then(res => console.log(res.data));

响应示例

response.json

{
    "object_key": "文件在 COS 中的路径，按日期分目录 preview-tmp\/YYYYMMDD\/<hash><后缀>（去重依据）",
    "view_url": "预览访问地址，浏览器直接打开即可预览，已包含签名、有效期、标题等参数",
    "expire_hours": 0,
    "expires_at": "签名到期时刻（本地时间），即源文件被自动删除的时刻（auto_delete=true 时）",
    "auto_delete": false
}

接口信息

请求地址 https://api.zhuimengapi.com/api/v1/html

请求方式 POST

Content-Type application/json

鉴权方式 X-API-Key: RPA-xxxxxxxx

请求参数

url string 必填

公网可访问的文档 URL。支持的输入格式：ppt、doc、xls、pdf、txt、rtf、html 等，单文件 ≤200MB、≤5000 页

expire int

签名有效期，单位小时，默认 168（7天），上限 7200（300天）

title string

预览 HTML 标题，不传默认"追梦网络-文档预览服务"

copyable string

"0" 不可复制，"1" 可复制，默认可复制

waterword string

水印文字，明文，服务端自动做 URL 安全 Base64

返回字段

object_key string

文件在 COS 中的路径，按日期分目录 preview-tmp/YYYYMMDD/<hash><后缀>（去重依据）

view_url string

预览访问地址，浏览器直接打开即可预览，已包含签名、有效期、标题等参数

expire_hours int

本次签名有效期（小时），等于传入的 expire

expires_at string

签名到期时刻（本地时间），即源文件被自动删除的时刻（auto_delete=true 时）

auto_delete bool

是否在签名过期后自动删除 COS 源文件，默认 true

响应状态说明

不同接口的成功返回字段可能不同，请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构，失败调用不计费。

200 请求成功返回字段以本接口的响应示例和实际结果为准，部分接口不包含 code 字段。按接口规则计费
400 参数或业务错误请求参数无效时返回安全、明确的修正提示。不扣费
401 API Key 无效密钥缺失、格式错误、无效或已经过期。不扣费
402 账户余额不足请充值后重试；本次请求不会进入接口处理。不扣费
403 访问被拒绝IP 规则限制，或当前账户无权调用仅限 VIP 的接口。不扣费
404 接口路由不存在请检查请求地址中的 API 路由是否正确。不扣费
405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法，并查看 Allow 响应头。不扣费
413 请求体过大单次请求最大允许 20MB。不扣费
429 请求频率超限请根据 Retry-After 响应头稍后重试。不扣费
500 系统服务异常请稍后重试；持续出现时请向技术支持提供 request_id。不扣费
502 接口服务暂时不可用接口处理异常或暂时不可用，请稍后重试。不扣费
503 系统服务暂时不可用服务正在恢复，请稍后重试。不扣费

错误响应示例使用 request_id 查询对应调用日志

{
  "code": 400,
  "message": "请输入有效的身份证号码",
  "data": null,
  "request_id": "1-xxxxxxxx",
  "time": "2026-07-29 12:00:00"
}

请求地址 https://api.zhuimengapi.com/api/v1/html

请求方式 POST

Content-Type application/json

鉴权 Header X-API-Key

API Key

Params Body

Params GET 请求只通过 URL 查询参数发送

Body JSON 模式 POST + application/json 使用原始 JSON 请求体

request body (JSON)

{
    "url": "公网可访问的文档 URL。支持的输入格式：ppt、doc、xls、pdf、txt、rtf、html 等，单文件 ≤200MB、≤5000 页",
    "expire": 0,
    "title": "预览 HTML 标题，不传默认\"追梦网络-文档预览服务\"",
    "copyable": "\"0\" 不可复制，\"1\" 可复制，默认可复制",
    "waterword": "水印文字，明文，服务端自动做 URL 安全 Base64"
}

快速信息

接口路由	`html`
接口分类	-
请求方式	POST
计费方式	1 积分/次（约 ¥0.05/次）
频率限制	不限制
认证方式	`X-API-Key`
接口提供	官方接口

如何调用

注册/登录本站账号
前往用户中心 → API密钥，创建一个密钥
在请求头添加 X-API-Key 携带密钥即可调用
每次成功调用将扣除 1 积分

前往创建 API 密钥