全能转

概述

80+种格式互转，70+个自定义参数！能进行各种常见格式之间的互相转换，不仅是word等office文件和pdf互转。拥有强大的OCR支持，对扫描件、拍照件可识别成可编辑 Word/Excel、可改可搜PDF，拍照表格可进 Excel，网址可导出正式文件等。提供了丰富的自定义参数，支持水印、压缩，加解密、页面大小范围等等。按次计费、不按页数。

使用流程

1. 调用文档格式转换接口，提交输入文件和转换参数。
2. 接口立即返回 token，表示任务已创建成功。
3. 后续通过以下任一方式获取结果： 调用查询结果接口轮询任务状态；或在 options 中传入 callbackUrl，等待系统回调，详细见回调URL。

调用文档格式转换 API 需要签名，详细见文档附录：阿里签名。

---

阿里云支持从OSS内网直接下载文件，节约流量，见：阿里云独有部分

文档格式转换

https://all2doc.market.alicloudapi.com/convert_async

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见阿里签名规则:

https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/use-cases/call-apis

支持的输出格式

支持的输入格式

请求参数

多数场景只需传 input 与 outputFormat 即可完成转换。需要精细控制时，可在 options 中传入可选参数，例如：

• Office / PDF / 图片 / 网页 / EPUB / CAD：页码范围、OCR、密码、审阅标记、Excel 页边距与工作表、PPT 讲义布局、图片纠偏与背景、网页视口与边距、CAD 图层与品质等
• 输出控制：文件名、回调 URL、PDF 压缩/加密/线性化、图片每页一图/长图/动图、HTML 大纲与嵌入模式、Word/Excel/Txt 布局策略、水印等

请求示例

• 例1: Word 转 PDF

{"input": "http://xxx.docx", "outputFormat": "pdf"}

• 例2: Word 转 PNG（每页一张图）

{"input": "http://xxx.docx", "outputFormat": "png"}

• 例3: PDF 转长图

{"input": "http://xxx.pdf", "outputFormat": "png", "options": {"imageOutputMode": "longImage", "longImageWidth": 1200}}

• 例4: PPT 转动图

{"input": "http://xxx.pptx", "outputFormat": "jpg", "options": {"imageOutputMode": "animatedGif", "animationFrameDurationSeconds": 2}}

• 例5: PDF 转 Word，并指定 OCR

{
  "input": "http://xxx.pdf",
  "inputFormat": "pdf",
  "outputFormat": "docx",
  "options": {"ocrMode": "auto", "ocrLanguage": "zh-CN"}
}

• 例6: 多张图片转 Word（URL 与 Base64 可混合）

{
  "input": ["http://xxx.png", "base64图片1", "base64图片2"],
  "outputFormat": "docx"
}

• 例7: Base64 文档转 HTML，指定结果文件名

{
  "input": "base64字符串",
  "inputFormat": "docx",
  "outputFormat": "html",
  "options": {"outputFileName": "result"}
}

• 例8: 网页 URL 转 Word

{
  "input": "https://www.xxx.com/xxx",
  "inputFormat": "url",
  "outputFormat": "docx"
}

• 例9: 网页 URL 转 Word，并设置回调

{
  "input": "https://www.example.com/article/123",
  "inputFormat": "url",
  "outputFormat": "docx",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

• 例10: PDF 第 2 页转 DWG

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "2"}
}

• 例11: PDF 第 1、3、5-7 页转 DWG（每个 PDF 页对应一个 Layout）

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "1,3,5-7"}
}

• 例12: Excel 转 PDF，并将每张工作表调整为一页

{
  "input": "http://xxx.xlsx",
  "outputFormat": "pdf",
  "options": {"excelPageFitMode": "fitSheetOnOnePage"}
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

转换能力说明

• 输入与输出格式可任意组合，但inputFormat 与 outputFormat 相同时会直接报错（例如 docx→docx 不合法）。特例：pdf→pdf 合法。
• Office 新旧格式可互转（doc→docx、ppt→pptx、xls→xlsx）保留原生 Office 结构。
• input 为数组时只支持图片，不能传文档数组。最大支持50张图。
• inputFormat=url 时，input 必须是单个 HTTP/HTTPS URL 字符串，不能是数组、Base64 或 ftp。
• PDF 转 DWG/DXF 支持单页或多页，仅适用于包含线条或文字等矢量内容的 PDF。扫描件和纯图片页不会自动矢量化。OCR、纠偏、背景清理等图片识别参数不生效。所选页全部无矢量内容时会明确返回失败，而不是生成仅引用临时图片的 CAD 文件；多页中仅部分页无矢量时，这些页生成空 Layout，其余页正常转换。单页结果在模型空间。多页为单个 CAD 文件，每个 PDF 页对应一个 Layout（图纸空间），名称如 page-1。多页 DXF 以 zip 包返回（内含一个 dxf 文件）；单页 DXF 和 DWG 直接返回对应文件。

查询结果

调用方式： GET（无需签名）

https://api.duhuitech.com/q?token=YOUR_TOKEN

请求参数：

由于转换需要时间，文件越大页数越多，转换越久，故需要轮询查询接口来获得结果。查询频率可以是1s一次，也可以更长一些。 查询后先看status，如果是Done或Failed，则转换结束，停止轮询。如果是Doing或Pending，则继续轮询。

返回数据结构：

result:

结果读取规则：

1. 先看 status。
2. 若 status=Done：
   • outputFormat 为 jpg / png（文档转图片）：读取 fileurls（数组；长图和动图也各返回一个 URL）。
   • 其他输出格式：读取 fileurl（单个字符串）。
3. 若 status=Failed：读取 reason。
4. 若 status=Doing 或 Pending：可读取 progress，继续轮询。

返回示例(进行中)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"progress":0.02,
		"status":"Doing"
	}
}

返回示例(成功，单文件，如 PDF/Word/HTML)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"count":10,
		"filesize":17747
	}
}

返回示例(成功，文档转图片，多页)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png",
			"https://file.duhuitech.com/o/xxx/3.png"
		],
		"count":3,
		"filesize":1649699
	}
}

返回示例(成功，文档转图片，仅一页也返回数组)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.jpg"
		],
		"count":1,
		"filesize":20480
	}
}

返回示例(失败状态)：

{
	"code":40000,
	"msg":"No such token"
}

或：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Failed",
		"reason":"convert failed"
	}
}

参数列表 options

注意事项：整数参数使用标准 JSON 数字，布尔使用 JSON true / false，枚举使用语义字符串（如 source / landscape / portrait）。未知字段、类型错误、枚举或范围错误会返回参数错误。

输入 Office 文件相关（inputFormat 为 Word / PPT / Excel / WPS 等）

输入 PDF 相关（inputFormat=pdf）

输入图片相关（inputFormat 为 jpg/png/img 等，或 input 为图片数组）

输入网址 / 网页相关（inputFormat=url，或 html / md 等）

输入 EPUB 相关（inputFormat=epub 等）

输入 CAD 文件相关（inputFormat 为 dwg / dxf 等）

---

通用输出

输出 PDF 相关（outputFormat=pdf）

输出图片相关（outputFormat=jpg / png）

图片格式由 outputFormat 决定。通过 imageOutputMode 选择每页一图、长图或动图；动图固定输出 GIF，outputFormat 不影响动图格式。

输出 HTML 相关（outputFormat=html）

输出 Word/PPT/Excel/Txt/OFD/Markdown 相关（outputFormat 为 docx / pptx / xlsx / txt / ofd / md 等）

输出水印相关

OCR 语言（ocrLanguage）

取值不区分大小写。

备注：

• 输入文件 URL 方式支持文件最大 1500M；Base64 方式最大 8M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

上述最后2项有延长需求请联系客服：

---

回调URL：

用途： 客户可以自行部署服务器，系统转换结束后会调用客户提供的回调URL，直接发送转换结果，从而无需再轮询查询结果。

在转换请求的 options 中传入 callbackUrl。当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

以POST方式调用该URL，Header头中Content-Type: application/json

Body为JSON格式，内容和查询结果的结果相同。例如单文件：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.docx",
		"filesize":17747,
		"count":1
	}
}

文档转图片时同样返回 fileurls：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png"
		],
		"count":2,
		"filesize":120000
	}
}

服务端收到该POST后需在10秒内返回HTTP STATUS CODE 200，视为调用成功，否则系统认为回调失败，会再次尝试。规则如下：

系统共计最多会调用3次回调URL，如果第一次失败，则等待3秒后尝试第二次，如果第二次失败，则等待5秒后尝试第三次，如果第三次失败，则不再尝试。

回调URL超时时间10秒。

---

关于下载转换后的文件需支持302跳转

接口返回的下载地址（如 fileurl / fileurls）会经 HTTP 302 跳转到实际文件。浏览器会自动跟随。

以下方式默认会跟随跳转，一般无需额外配置：

wget、Python requests / urllib、Node.js axios / got / fetch、Java OkHttp / HttpURLConnection、Go net/http、C# HttpClient、PHP file_get_contents、Objective-C / Swift NSURLSession / URLSession（含 Alamofire）

少数默认不跟随，需手动打开：

• curl：加 -L，如 curl -L -o out.bin "下载地址"
• Java java.net.http.HttpClient：设置 .followRedirects(HttpClient.Redirect.NORMAL)
• PHP curl 扩展：设置 CURLOPT_FOLLOWLOCATION => true

若只拿到 302 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

阿里云独有部分：

支持从阿里云OSS内网直接下载文件，目前支持的是上海地区的阿里云OSS内网：

oss-cn-shanghai-internal.aliyuncs.com

请求里的文件 URL 包含上述域名则自动支持。

---

错误码表：

返回的code如果是10000，代表成功，其余是失败

附录：阿里签名方式

参考链接：

https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/use-cases/call-apis

在调用API商品时，首先您需要了解采用哪种API认证方式，云市场API商品的认证方式主要有以下两种方式。两种方式可同时使用，您可以根据不同情况来选择。

• 简单身份认证（AppCode）

• 签名认证

简单身份认证（AppCode）

简单认证（AppCode）调用API，有两种方式，一种是将AppCode放在Header中进行调用，一种是将AppCode放在Query参数中进行调用。

方式一：将AppCode放在Header中

在请求Header中添加一个Authorization参数。

Authorization字段的值的格式为APPCODE ＋ 半角空格 ＋APPCODE值。格式如下：

Authorization:APPCODE AppCode值

示例：

Authorization:APPCODE YOUR_CREDENTIAL

方式二：将AppCode放在Query中

在请求Query中添加AppCode参数（同时支持appcode , appCode , APPCODE , APPCode四种写法）。

AppCode参数的值为AppCode的值。

示例：

http://www.aliyum.com?AppCode=YOUR_CREDENTIAL

参考链接：https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/user-guide/call-an-api-operation-by-using-an-appcode

签名认证

比较复杂，推荐用阿里自己的SDK来调用，参考链接：https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/user-guide/use-digest-authentication-to-call-an-api

概述

80+种格式互转，70+个自定义参数！能进行各种常见格式之间的互相转换，不仅是word等office文件和pdf互转。拥有强大的OCR支持，对扫描件、拍照件可识别成可编辑 Word/Excel、可改可搜PDF，拍照表格可进 Excel，网址可导出正式文件等。提供了丰富的自定义参数，支持水印、压缩，加解密、页面大小范围等等。按次计费、不按页数。

使用流程

1. 调用文档格式转换接口，提交输入文件和转换参数。
2. 接口立即返回 token，表示任务已创建成功。
3. 后续通过以下任一方式获取结果： 调用查询结果接口轮询任务状态；或在 options 中传入 callbackUrl，等待系统回调，详细见回调URL。

调用文档格式转换 API 需要签名，详细见文档附录：百度签名。

文档格式转换

https://gwgp-phja4guvncn.n.bdcloudapi.com/convert_async

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见百度签名规则：

https://cloud.baidu.com/doc/APIGW/s/Ljx2m1qc4

支持的输出格式

支持的输入格式

请求参数

多数场景只需传 input 与 outputFormat 即可完成转换。需要精细控制时，可在 options 中传入可选参数，例如：

• Office / PDF / 图片 / 网页 / EPUB / CAD：页码范围、OCR、密码、审阅标记、Excel 页边距与工作表、PPT 讲义布局、图片纠偏与背景、网页视口与边距、CAD 图层与品质等
• 输出控制：文件名、回调 URL、PDF 压缩/加密/线性化、图片每页一图/长图/动图、HTML 大纲与嵌入模式、Word/Excel/Txt 布局策略、水印等

请求示例

• 例1: Word 转 PDF

{"input": "http://xxx.docx", "outputFormat": "pdf"}

• 例2: Word 转 PNG（每页一张图）

{"input": "http://xxx.docx", "outputFormat": "png"}

• 例3: PDF 转长图

{"input": "http://xxx.pdf", "outputFormat": "png", "options": {"imageOutputMode": "longImage", "longImageWidth": 1200}}

• 例4: PPT 转动图

{"input": "http://xxx.pptx", "outputFormat": "jpg", "options": {"imageOutputMode": "animatedGif", "animationFrameDurationSeconds": 2}}

• 例5: PDF 转 Word，并指定 OCR

{
  "input": "http://xxx.pdf",
  "inputFormat": "pdf",
  "outputFormat": "docx",
  "options": {"ocrMode": "auto", "ocrLanguage": "zh-CN"}
}

• 例6: 多张图片转 Word（URL 与 Base64 可混合）

{
  "input": ["http://xxx.png", "base64图片1", "base64图片2"],
  "outputFormat": "docx"
}

• 例7: Base64 文档转 HTML，指定结果文件名

{
  "input": "base64字符串",
  "inputFormat": "docx",
  "outputFormat": "html",
  "options": {"outputFileName": "result"}
}

• 例8: 网页 URL 转 Word

{
  "input": "https://www.xxx.com/xxx",
  "inputFormat": "url",
  "outputFormat": "docx"
}

• 例9: 网页 URL 转 Word，并设置回调

{
  "input": "https://www.example.com/article/123",
  "inputFormat": "url",
  "outputFormat": "docx",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

• 例10: PDF 第 2 页转 DWG

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "2"}
}

• 例11: PDF 第 1、3、5-7 页转 DWG（每个 PDF 页对应一个 Layout）

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "1,3,5-7"}
}

• 例12: Excel 转 PDF，并将每张工作表调整为一页

{
  "input": "http://xxx.xlsx",
  "outputFormat": "pdf",
  "options": {"excelPageFitMode": "fitSheetOnOnePage"}
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

转换能力说明

• 输入与输出格式可任意组合，但inputFormat 与 outputFormat 相同时会直接报错（例如 docx→docx 不合法）。特例：pdf→pdf 合法。
• Office 新旧格式可互转（doc→docx、ppt→pptx、xls→xlsx）保留原生 Office 结构。
• input 为数组时只支持图片，不能传文档数组。最大支持50张图。
• inputFormat=url 时，input 必须是单个 HTTP/HTTPS URL 字符串，不能是数组、Base64 或 ftp。
• PDF 转 DWG/DXF 支持单页或多页，仅适用于包含线条或文字等矢量内容的 PDF。扫描件和纯图片页不会自动矢量化。OCR、纠偏、背景清理等图片识别参数不生效。所选页全部无矢量内容时会明确返回失败，而不是生成仅引用临时图片的 CAD 文件；多页中仅部分页无矢量时，这些页生成空 Layout，其余页正常转换。单页结果在模型空间。多页为单个 CAD 文件，每个 PDF 页对应一个 Layout（图纸空间），名称如 page-1。多页 DXF 以 zip 包返回（内含一个 dxf 文件）；单页 DXF 和 DWG 直接返回对应文件。

查询结果

调用方式： GET（无需签名）

https://api.duhuitech.com/q?token=YOUR_TOKEN

请求参数：

由于转换需要时间，文件越大页数越多，转换越久，故需要轮询查询接口来获得结果。查询频率可以是1s一次，也可以更长一些。 查询后先看status，如果是Done或Failed，则转换结束，停止轮询。如果是Doing或Pending，则继续轮询。

返回数据结构：

result:

结果读取规则：

1. 先看 status。
2. 若 status=Done：
   • outputFormat 为 jpg / png（文档转图片）：读取 fileurls（数组；长图和动图也各返回一个 URL）。
   • 其他输出格式：读取 fileurl（单个字符串）。
3. 若 status=Failed：读取 reason。
4. 若 status=Doing 或 Pending：可读取 progress，继续轮询。

返回示例(进行中)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"progress":0.02,
		"status":"Doing"
	}
}

返回示例(成功，单文件，如 PDF/Word/HTML)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"count":10,
		"filesize":17747
	}
}

返回示例(成功，文档转图片，多页)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png",
			"https://file.duhuitech.com/o/xxx/3.png"
		],
		"count":3,
		"filesize":1649699
	}
}

返回示例(成功，文档转图片，仅一页也返回数组)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.jpg"
		],
		"count":1,
		"filesize":20480
	}
}

返回示例(失败状态)：

{
	"code":40000,
	"msg":"No such token"
}

或：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Failed",
		"reason":"convert failed"
	}
}

参数列表 options

注意事项：整数参数使用标准 JSON 数字，布尔使用 JSON true / false，枚举使用语义字符串（如 source / landscape / portrait）。未知字段、类型错误、枚举或范围错误会返回参数错误。

输入 Office 文件相关（inputFormat 为 Word / PPT / Excel / WPS 等）

输入 PDF 相关（inputFormat=pdf）

输入图片相关（inputFormat 为 jpg/png/img 等，或 input 为图片数组）

输入网址 / 网页相关（inputFormat=url，或 html / md 等）

输入 EPUB 相关（inputFormat=epub 等）

输入 CAD 文件相关（inputFormat 为 dwg / dxf 等）

---

通用输出

输出 PDF 相关（outputFormat=pdf）

输出图片相关（outputFormat=jpg / png）

图片格式由 outputFormat 决定。通过 imageOutputMode 选择每页一图、长图或动图；动图固定输出 GIF，outputFormat 不影响动图格式。

输出 HTML 相关（outputFormat=html）

输出 Word/PPT/Excel/Txt/OFD/Markdown 相关（outputFormat 为 docx / pptx / xlsx / txt / ofd / md 等）

输出水印相关

OCR 语言（ocrLanguage）

取值不区分大小写。

备注：

• 输入文件 URL 方式支持文件最大 1500M；Base64 方式最大 8M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

上述最后2项有延长需求请联系客服：

---

回调URL：

用途： 客户可以自行部署服务器，系统转换结束后会调用客户提供的回调URL，直接发送转换结果，从而无需再轮询查询结果。

在转换请求的 options 中传入 callbackUrl。当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

以POST方式调用该URL，Header头中Content-Type: application/json

Body为JSON格式，内容和查询结果的结果相同。例如单文件：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.docx",
		"filesize":17747,
		"count":1
	}
}

文档转图片时同样返回 fileurls：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png"
		],
		"count":2,
		"filesize":120000
	}
}

服务端收到该POST后需在10秒内返回HTTP STATUS CODE 200，视为调用成功，否则系统认为回调失败，会再次尝试。规则如下：

系统共计最多会调用3次回调URL，如果第一次失败，则等待3秒后尝试第二次，如果第二次失败，则等待5秒后尝试第三次，如果第三次失败，则不再尝试。

回调URL超时时间10秒。

---

关于下载转换后的文件需支持302跳转

接口返回的下载地址（如 fileurl / fileurls）会经 HTTP 302 跳转到实际文件。浏览器会自动跟随。

以下方式默认会跟随跳转，一般无需额外配置：

wget、Python requests / urllib、Node.js axios / got / fetch、Java OkHttp / HttpURLConnection、Go net/http、C# HttpClient、PHP file_get_contents、Objective-C / Swift NSURLSession / URLSession（含 Alamofire）

少数默认不跟随，需手动打开：

• curl：加 -L，如 curl -L -o out.bin "下载地址"
• Java java.net.http.HttpClient：设置 .followRedirects(HttpClient.Redirect.NORMAL)
• PHP curl 扩展：设置 CURLOPT_FOLLOWLOCATION => true

若只拿到 302 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

返回的code如果是10000，代表成功，其余是失败

附录：百度签名方式

参考链接：

https://cloud.baidu.com/doc/APIGW/s/Ljx2m1qc4

在调用API商品时，首先您需要了解采用哪种API认证方式。云市场API商品的认证方式主要有以下两种方式，两种方式可同时使用，您可以根据不同情况来选择：

• 简单身份认证（AppCode）
• 签名认证

简单身份认证（AppCode）

简单认证（AppCode）调用API，将AppCode放在Header中。在请求Header中添加一个X-Bce-Signature参数。

示例：

X-Bce-Signature: AppCode/YOUR_APPCODE

签名认证

签名认证比较复杂，推荐用百度自己的SDK来调用，参考链接：

https://cloud.baidu.com/doc/Reference/s/njwvz1yfu

概述

80+种格式互转，70+个自定义参数！能进行各种常见格式之间的互相转换，不仅是word等office文件和pdf互转。拥有强大的OCR支持，对扫描件、拍照件可识别成可编辑 Word/Excel、可改可搜PDF，拍照表格可进 Excel，网址可导出正式文件等。提供了丰富的自定义参数，支持水印、压缩，加解密、页面大小范围等等。按次计费、不按页数。

使用流程

1. 调用文档格式转换接口，提交输入文件和转换参数。
2. 接口立即返回 token，表示任务已创建成功。
3. 后续通过以下任一方式获取结果： 调用查询结果接口轮询任务状态；或在 options 中传入 callbackUrl，等待系统回调，详细见回调URL。

调用文档格式转换 API 需要签名，详细见文档附录：华为签名。

文档格式转换

http://all2doc.apistore.huaweicloud.com/convert_async

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见华为签名规则：

https://support.huaweicloud.com/usermanual-apig/apig-ug-0011.html

支持的输出格式

支持的输入格式

请求参数

多数场景只需传 input 与 outputFormat 即可完成转换。需要精细控制时，可在 options 中传入可选参数，例如：

• Office / PDF / 图片 / 网页 / EPUB / CAD：页码范围、OCR、密码、审阅标记、Excel 页边距与工作表、PPT 讲义布局、图片纠偏与背景、网页视口与边距、CAD 图层与品质等
• 输出控制：文件名、回调 URL、PDF 压缩/加密/线性化、图片每页一图/长图/动图、HTML 大纲与嵌入模式、Word/Excel/Txt 布局策略、水印等

请求示例

• 例1: Word 转 PDF

{"input": "http://xxx.docx", "outputFormat": "pdf"}

• 例2: Word 转 PNG（每页一张图）

{"input": "http://xxx.docx", "outputFormat": "png"}

• 例3: PDF 转长图

{"input": "http://xxx.pdf", "outputFormat": "png", "options": {"imageOutputMode": "longImage", "longImageWidth": 1200}}

• 例4: PPT 转动图

{"input": "http://xxx.pptx", "outputFormat": "jpg", "options": {"imageOutputMode": "animatedGif", "animationFrameDurationSeconds": 2}}

• 例5: PDF 转 Word，并指定 OCR

{
  "input": "http://xxx.pdf",
  "inputFormat": "pdf",
  "outputFormat": "docx",
  "options": {"ocrMode": "auto", "ocrLanguage": "zh-CN"}
}

• 例6: 多张图片转 Word（URL 与 Base64 可混合）

{
  "input": ["http://xxx.png", "base64图片1", "base64图片2"],
  "outputFormat": "docx"
}

• 例7: Base64 文档转 HTML，指定结果文件名

{
  "input": "base64字符串",
  "inputFormat": "docx",
  "outputFormat": "html",
  "options": {"outputFileName": "result"}
}

• 例8: 网页 URL 转 Word

{
  "input": "https://www.xxx.com/xxx",
  "inputFormat": "url",
  "outputFormat": "docx"
}

• 例9: 网页 URL 转 Word，并设置回调

{
  "input": "https://www.example.com/article/123",
  "inputFormat": "url",
  "outputFormat": "docx",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

• 例10: PDF 第 2 页转 DWG

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "2"}
}

• 例11: PDF 第 1、3、5-7 页转 DWG（每个 PDF 页对应一个 Layout）

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "1,3,5-7"}
}

• 例12: Excel 转 PDF，并将每张工作表调整为一页

{
  "input": "http://xxx.xlsx",
  "outputFormat": "pdf",
  "options": {"excelPageFitMode": "fitSheetOnOnePage"}
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

转换能力说明

• 输入与输出格式可任意组合，但inputFormat 与 outputFormat 相同时会直接报错（例如 docx→docx 不合法）。特例：pdf→pdf 合法。
• Office 新旧格式可互转（doc→docx、ppt→pptx、xls→xlsx）保留原生 Office 结构。
• input 为数组时只支持图片，不能传文档数组。最大支持50张图。
• inputFormat=url 时，input 必须是单个 HTTP/HTTPS URL 字符串，不能是数组、Base64 或 ftp。
• PDF 转 DWG/DXF 支持单页或多页，仅适用于包含线条或文字等矢量内容的 PDF。扫描件和纯图片页不会自动矢量化。OCR、纠偏、背景清理等图片识别参数不生效。所选页全部无矢量内容时会明确返回失败，而不是生成仅引用临时图片的 CAD 文件；多页中仅部分页无矢量时，这些页生成空 Layout，其余页正常转换。单页结果在模型空间。多页为单个 CAD 文件，每个 PDF 页对应一个 Layout（图纸空间），名称如 page-1。多页 DXF 以 zip 包返回（内含一个 dxf 文件）；单页 DXF 和 DWG 直接返回对应文件。

查询结果

调用方式： GET（无需签名）

https://api.duhuitech.com/q?token=YOUR_TOKEN

请求参数：

由于转换需要时间，文件越大页数越多，转换越久，故需要轮询查询接口来获得结果。查询频率可以是1s一次，也可以更长一些。 查询后先看status，如果是Done或Failed，则转换结束，停止轮询。如果是Doing或Pending，则继续轮询。

返回数据结构：

result:

结果读取规则：

1. 先看 status。
2. 若 status=Done：
   • outputFormat 为 jpg / png（文档转图片）：读取 fileurls（数组；长图和动图也各返回一个 URL）。
   • 其他输出格式：读取 fileurl（单个字符串）。
3. 若 status=Failed：读取 reason。
4. 若 status=Doing 或 Pending：可读取 progress，继续轮询。

返回示例(进行中)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"progress":0.02,
		"status":"Doing"
	}
}

返回示例(成功，单文件，如 PDF/Word/HTML)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"count":10,
		"filesize":17747
	}
}

返回示例(成功，文档转图片，多页)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png",
			"https://file.duhuitech.com/o/xxx/3.png"
		],
		"count":3,
		"filesize":1649699
	}
}

返回示例(成功，文档转图片，仅一页也返回数组)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.jpg"
		],
		"count":1,
		"filesize":20480
	}
}

返回示例(失败状态)：

{
	"code":40000,
	"msg":"No such token"
}

或：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Failed",
		"reason":"convert failed"
	}
}

参数列表 options

注意事项：整数参数使用标准 JSON 数字，布尔使用 JSON true / false，枚举使用语义字符串（如 source / landscape / portrait）。未知字段、类型错误、枚举或范围错误会返回参数错误。

输入 Office 文件相关（inputFormat 为 Word / PPT / Excel / WPS 等）

输入 PDF 相关（inputFormat=pdf）

输入图片相关（inputFormat 为 jpg/png/img 等，或 input 为图片数组）

输入网址 / 网页相关（inputFormat=url，或 html / md 等）

输入 EPUB 相关（inputFormat=epub 等）

输入 CAD 文件相关（inputFormat 为 dwg / dxf 等）

---

通用输出

输出 PDF 相关（outputFormat=pdf）

输出图片相关（outputFormat=jpg / png）

图片格式由 outputFormat 决定。通过 imageOutputMode 选择每页一图、长图或动图；动图固定输出 GIF，outputFormat 不影响动图格式。

输出 HTML 相关（outputFormat=html）

输出 Word/PPT/Excel/Txt/OFD/Markdown 相关（outputFormat 为 docx / pptx / xlsx / txt / ofd / md 等）

输出水印相关

OCR 语言（ocrLanguage）

取值不区分大小写。

备注：

• 输入文件 URL 方式支持文件最大 1500M；Base64 方式最大 12M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

上述最后2项有延长需求请联系客服：

---

回调URL：

用途： 客户可以自行部署服务器，系统转换结束后会调用客户提供的回调URL，直接发送转换结果，从而无需再轮询查询结果。

在转换请求的 options 中传入 callbackUrl。当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

以POST方式调用该URL，Header头中Content-Type: application/json

Body为JSON格式，内容和查询结果的结果相同。例如单文件：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.docx",
		"filesize":17747,
		"count":1
	}
}

文档转图片时同样返回 fileurls：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png"
		],
		"count":2,
		"filesize":120000
	}
}

服务端收到该POST后需在10秒内返回HTTP STATUS CODE 200，视为调用成功，否则系统认为回调失败，会再次尝试。规则如下：

系统共计最多会调用3次回调URL，如果第一次失败，则等待3秒后尝试第二次，如果第二次失败，则等待5秒后尝试第三次，如果第三次失败，则不再尝试。

回调URL超时时间10秒。

---

关于下载转换后的文件需支持302跳转

接口返回的下载地址（如 fileurl / fileurls）会经 HTTP 302 跳转到实际文件。浏览器会自动跟随。

以下方式默认会跟随跳转，一般无需额外配置：

wget、Python requests / urllib、Node.js axios / got / fetch、Java OkHttp / HttpURLConnection、Go net/http、C# HttpClient、PHP file_get_contents、Objective-C / Swift NSURLSession / URLSession（含 Alamofire）

少数默认不跟随，需手动打开：

• curl：加 -L，如 curl -L -o out.bin "下载地址"
• Java java.net.http.HttpClient：设置 .followRedirects(HttpClient.Redirect.NORMAL)
• PHP curl 扩展：设置 CURLOPT_FOLLOWLOCATION => true

若只拿到 302 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

返回的code如果是10000，代表成功，其余是失败

附录：华为签名方式

参考链接：

https://support.huaweicloud.com/usermanual-apig/apig-ug-0011.html

调用华为云市场API需要按照华为官方文档进行签名认证。

概述

80+种格式互转，70+个自定义参数！能进行各种常见格式之间的互相转换，不仅是word等office文件和pdf互转。拥有强大的OCR支持，对扫描件、拍照件可识别成可编辑 Word/Excel、可改可搜PDF，拍照表格可进 Excel，网址可导出正式文件等。提供了丰富的自定义参数，支持水印、压缩，加解密、页面大小范围等等。按次计费、不按页数。

使用流程

1. 调用文档格式转换接口，提交输入文件和转换参数。
2. 接口立即返回 token，表示任务已创建成功。
3. 后续通过以下任一方式获取结果： 调用查询结果接口轮询任务状态；或在 options 中传入 callbackUrl，等待系统回调，详细见回调URL。

调用文档格式转换 API 需要签名，详细见文档附录：腾讯签名规则。

文档格式转换

域名：

https://ap-shanghai.cloudmarket-apigw.com/service-i0k5hgdj/convert_async

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见腾讯签名规则：

支持的输出格式

支持的输入格式

请求参数

多数场景只需传 input 与 outputFormat 即可完成转换。需要精细控制时，可在 options 中传入可选参数，例如：

• Office / PDF / 图片 / 网页 / EPUB / CAD：页码范围、OCR、密码、审阅标记、Excel 页边距与工作表、PPT 讲义布局、图片纠偏与背景、网页视口与边距、CAD 图层与品质等
• 输出控制：文件名、回调 URL、PDF 压缩/加密/线性化、图片每页一图/长图/动图、HTML 大纲与嵌入模式、Word/Excel/Txt 布局策略、水印等

请求示例

• 例1: Word 转 PDF

{"input": "http://xxx.docx", "outputFormat": "pdf"}

• 例2: Word 转 PNG（每页一张图）

{"input": "http://xxx.docx", "outputFormat": "png"}

• 例3: PDF 转长图

{"input": "http://xxx.pdf", "outputFormat": "png", "options": {"imageOutputMode": "longImage", "longImageWidth": 1200}}

• 例4: PPT 转动图

{"input": "http://xxx.pptx", "outputFormat": "jpg", "options": {"imageOutputMode": "animatedGif", "animationFrameDurationSeconds": 2}}

• 例5: PDF 转 Word，并指定 OCR

{
  "input": "http://xxx.pdf",
  "inputFormat": "pdf",
  "outputFormat": "docx",
  "options": {"ocrMode": "auto", "ocrLanguage": "zh-CN"}
}

• 例6: 多张图片转 Word（URL 与 Base64 可混合）

{
  "input": ["http://xxx.png", "base64图片1", "base64图片2"],
  "outputFormat": "docx"
}

• 例7: Base64 文档转 HTML，指定结果文件名

{
  "input": "base64字符串",
  "inputFormat": "docx",
  "outputFormat": "html",
  "options": {"outputFileName": "result"}
}

• 例8: 网页 URL 转 Word

{
  "input": "https://www.xxx.com/xxx",
  "inputFormat": "url",
  "outputFormat": "docx"
}

• 例9: 网页 URL 转 Word，并设置回调

{
  "input": "https://www.example.com/article/123",
  "inputFormat": "url",
  "outputFormat": "docx",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

• 例10: PDF 第 2 页转 DWG

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "2"}
}

• 例11: PDF 第 1、3、5-7 页转 DWG（每个 PDF 页对应一个 Layout）

{
  "input": "http://xxx.pdf",
  "outputFormat": "dwg",
  "options": {"pageRanges": "1,3,5-7"}
}

• 例12: Excel 转 PDF，并将每张工作表调整为一页

{
  "input": "http://xxx.xlsx",
  "outputFormat": "pdf",
  "options": {"excelPageFitMode": "fitSheetOnOnePage"}
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

转换能力说明

• 输入与输出格式可任意组合，但inputFormat 与 outputFormat 相同时会直接报错（例如 docx→docx 不合法）。特例：pdf→pdf 合法。
• Office 新旧格式可互转（doc→docx、ppt→pptx、xls→xlsx）保留原生 Office 结构。
• input 为数组时只支持图片，不能传文档数组。最大支持50张图。
• inputFormat=url 时，input 必须是单个 HTTP/HTTPS URL 字符串，不能是数组、Base64 或 ftp。
• PDF 转 DWG/DXF 支持单页或多页，仅适用于包含线条或文字等矢量内容的 PDF。扫描件和纯图片页不会自动矢量化。OCR、纠偏、背景清理等图片识别参数不生效。所选页全部无矢量内容时会明确返回失败，而不是生成仅引用临时图片的 CAD 文件；多页中仅部分页无矢量时，这些页生成空 Layout，其余页正常转换。单页结果在模型空间。多页为单个 CAD 文件，每个 PDF 页对应一个 Layout（图纸空间），名称如 page-1。多页 DXF 以 zip 包返回（内含一个 dxf 文件）；单页 DXF 和 DWG 直接返回对应文件。

查询结果

调用方式： GET（无需签名）

https://api.duhuitech.com/q?token=YOUR_TOKEN

请求参数：

由于转换需要时间，文件越大页数越多，转换越久，故需要轮询查询接口来获得结果。查询频率可以是1s一次，也可以更长一些。 查询后先看status，如果是Done或Failed，则转换结束，停止轮询。如果是Doing或Pending，则继续轮询。

返回数据结构：

result:

结果读取规则：

1. 先看 status。
2. 若 status=Done：
   • outputFormat 为 jpg / png（文档转图片）：读取 fileurls（数组；长图和动图也各返回一个 URL）。
   • 其他输出格式：读取 fileurl（单个字符串）。
3. 若 status=Failed：读取 reason。
4. 若 status=Doing 或 Pending：可读取 progress，继续轮询。

返回示例(进行中)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"progress":0.02,
		"status":"Doing"
	}
}

返回示例(成功，单文件，如 PDF/Word/HTML)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"count":10,
		"filesize":17747
	}
}

返回示例(成功，文档转图片，多页)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png",
			"https://file.duhuitech.com/o/xxx/3.png"
		],
		"count":3,
		"filesize":1649699
	}
}

返回示例(成功，文档转图片，仅一页也返回数组)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.jpg"
		],
		"count":1,
		"filesize":20480
	}
}

返回示例(失败状态)：

{
	"code":40000,
	"msg":"No such token"
}

或：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Failed",
		"reason":"convert failed"
	}
}

参数列表 options

注意事项：整数参数使用标准 JSON 数字，布尔使用 JSON true / false，枚举使用语义字符串（如 source / landscape / portrait）。未知字段、类型错误、枚举或范围错误会返回参数错误。

输入 Office 文件相关（inputFormat 为 Word / PPT / Excel / WPS 等）

输入 PDF 相关（inputFormat=pdf）

输入图片相关（inputFormat 为 jpg/png/img 等，或 input 为图片数组）

输入网址 / 网页相关（inputFormat=url，或 html / md 等）

输入 EPUB 相关（inputFormat=epub 等）

输入 CAD 文件相关（inputFormat 为 dwg / dxf 等）

---

通用输出

输出 PDF 相关（outputFormat=pdf）

输出图片相关（outputFormat=jpg / png）

图片格式由 outputFormat 决定。通过 imageOutputMode 选择每页一图、长图或动图；动图固定输出 GIF，outputFormat 不影响动图格式。

输出 HTML 相关（outputFormat=html）

输出 Word/PPT/Excel/Txt/OFD/Markdown 相关（outputFormat 为 docx / pptx / xlsx / txt / ofd / md 等）

输出水印相关

OCR 语言（ocrLanguage）

取值不区分大小写。

备注：

• 输入文件 URL 方式支持文件最大 1500M；Base64 方式最大 10M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

上述最后2项有延长需求请联系客服：

---

回调URL：

用途： 客户可以自行部署服务器，系统转换结束后会调用客户提供的回调URL，直接发送转换结果，从而无需再轮询查询结果。

在转换请求的 options 中传入 callbackUrl。当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

以POST方式调用该URL，Header头中Content-Type: application/json

Body为JSON格式，内容和查询结果的结果相同。例如单文件：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.docx",
		"filesize":17747,
		"count":1
	}
}

文档转图片时同样返回 fileurls：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png"
		],
		"count":2,
		"filesize":120000
	}
}

服务端收到该POST后需在10秒内返回HTTP STATUS CODE 200，视为调用成功，否则系统认为回调失败，会再次尝试。规则如下：

系统共计最多会调用3次回调URL，如果第一次失败，则等待3秒后尝试第二次，如果第二次失败，则等待5秒后尝试第三次，如果第三次失败，则不再尝试。

回调URL超时时间10秒。

---

关于下载转换后的文件需支持302跳转

接口返回的下载地址（如 fileurl / fileurls）会经 HTTP 302 跳转到实际文件。浏览器会自动跟随。

以下方式默认会跟随跳转，一般无需额外配置：

wget、Python requests / urllib、Node.js axios / got / fetch、Java OkHttp / HttpURLConnection、Go net/http、C# HttpClient、PHP file_get_contents、Objective-C / Swift NSURLSession / URLSession（含 Alamofire）

少数默认不跟随，需手动打开：

• curl：加 -L，如 curl -L -o out.bin "下载地址"
• Java java.net.http.HttpClient：设置 .followRedirects(HttpClient.Redirect.NORMAL)
• PHP curl 扩展：设置 CURLOPT_FOLLOWLOCATION => true

若只拿到 302 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

返回的code如果是10000，代表成功，其余是失败

附录：腾讯签名方式

V2签名：

https://cloud.tencent.com/document/product/306/57449

建议使用腾讯提供的各种语言的SDK，例如Java：

https://cloud.tencent.com/document/product/306/57449#Java

V1签名：

本产品不支持V1签名方式