PDF 转 HTML

PDF 文本转换与 HTML 交付。仅支持文本型 PDF，单文件不超过 20 MiB、100 页；扫描型和加密 PDF 暂不支持。

正式接口使用 POST multipart/form-data，恰好上传一个 file，storage 为 public 或 private，默认 public。
AppKey 支持 Query、multipart、AppKey / X-GUGUDATA-APPKEY / X-API-Key Header 和 Bearer；同值可共存，冲突返回 501。

public 的 Data 为 HTML 地址；private 的 Data 保持 storage、file_id、file_name、content_type、size_bytes、index 六个字段。DataTotalCount 成功为 1，不表示页数。正式请求摘要不包含文件名或正文。

状态：100/200 成功；501/400 参数或文件错误；502/429 限流；503/403 到期；504/401 鉴权错误；505/403 额度耗尽；900/500 内部错误；901/503 暂时无法转换或交付。

接口详情：https://www.gugudata.com/api/details/pdf2html

文件用例供 Desktop/CLI 使用：工作目录选择 API 项目根目录，设置 pdf2htmlRunFileCases=true。样例相对路径为 assets/demos/pdf2html/v1/source.pdf；pdf2htmlStorage 可设 public 或 private。未启用文件用例时跳过本请求，Cloud 默认仅运行 Demo，不依赖本地文件。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 100,
    "RequestParameter": "input=file&format=pdf&bytes=0&storage=public",
    "StatusDescription": "转换成功",
    "ResponseDateTime": "2026-09-05 15:05:31.734",
    "DataTotalCount": 1
  },
  "Data": "https://cdn.gugudata.com/pdf2html/b8ebf106cd9041148719023c355219c6.html"
}

请求参数

请求示例代码

返回响应