PPT 转 PDF API：PPTX 上传、公开 URL 与私有下载

咕咕数据 PPT 转 PDF API 接收一个 PPT、PPTX 或 PPTM，支持本地文件上传和公开链接。默认返回 PDF 下载地址，私有模式返回用于授权下载的文件引用。

请求与参数

请求方法为 POST，示例使用 AppKey 请求头。替换本地占位凭据后再执行。

字段	类型	必填	说明
file	multipart 文件	与 url 二选一	单个 PPT、PPTX 或 PPTM
url	表单字符串	与 file 二选一	公开 HTTP/HTTPS 演示文稿地址
storage	表单字符串	否	public 为默认值，private 返回文件引用

curl -fsS 'https://api.gugudata.com/imagerecognition/ppt-to-pdf' \
  -H 'AppKey: YOUR_APPKEY' \
  -F 'file=@./source.pptx' \
  -F 'storage=private'

远程文件可用 --data-urlencode "url=https://example.com/source.pptx" 和 --data-urlencode "storage=private" 替换 multipart 字段。上传上限 100 MiB，公开 URL 实际读取上限 300 MiB，URL 下载最多 120 秒，转换总预算 300 秒。

响应与公开样例

先检查 HTTP 请求是否成功，再读取业务状态 DataStatus.StatusCode。业务码 100 时按下表读取结果。

字段	类型	用途
Data	字符串	public 模式的 PDF 下载地址
Data.file_id	字符串	private 模式的文件标识
Data.size_bytes	整数	private 模式的文件大小

下方是 2026 年 11 月 11 日公开 Demo 的响应节选，可直接请求样例核对实际结果。

curl -fsS 'https://api.gugudata.com/imagerecognition/ppt-to-pdf/demo'

{
  "DataStatus": {
    "StatusCode": 100,
    "DataTotalCount": 1
  },
  "Data": "https://cdn.gugudata.com/pdf/ppt-pdf-mtkkvk4d.pdf"
}

接入验收

场景	核对内容
文件安全	PPTM 转换过程不执行宏。
转换效果	逐页检查常用字体、图片、表格、图表及版式。动画和交互效果以 PDF 静态输出为准。
访问控制	内部演示资料使用私有文件引用，下载时单独授权。

完整参数、返回结构与接口说明见咕咕数据官方 API 文档。