EditablePPT

图片转 PPT API

输出可编辑 PowerPoint 的图片转 PPT API

用 API 密钥发送一张 PNG 或 JPG，拿回一个文字可编辑、画面拆成独立图层的 PPTX。与 EditablePPT 网页版使用同一套转换能力。

三个请求快速上手

创建 API 密钥，上传图片，轮询直到任务成功，再导出 PPTX。把 <ID> 替换为第一个请求返回的 id。

# 1. 上传 PNG 或 JPG，开始转换
curl -X POST "https://editableppt.com/api/image-conversions?quality=standard&title=Slide%201" \
  -H "Authorization: Bearer $EDITABLEPPT_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @slide.png
# → {"code":0,"message":"ok","data":{"id":"<ID>","status":"processing",...}}

# 2. 每隔几秒轮询一次，直到 status 为 success 或 failed
curl "https://editableppt.com/api/image-conversions?id=<ID>" \
  -H "Authorization: Bearer $EDITABLEPPT_API_KEY"

# 3. 下载可编辑的 PPTX
curl -X POST "https://editableppt.com/api/image-conversions/export" \
  -H "Authorization: Bearer $EDITABLEPPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["<ID>"],"title":"Slide 1"}' \
  -o slide.pptx
创建 API 密钥在浏览器中试用

为自动化幻灯片流程而设计

输出可编辑文件，不是截图

文字以原生 PowerPoint 文本框返回，字号和颜色与原图匹配；图标、照片和卡片成为独立的图片图层。

两种质量模式

标准模式快速拆出文字和图片图层，分层模式拆出五个景深图层并单独保留艺术字。每个请求用 quality 参数选择。

按张消耗积分

每个请求从你的账户扣除积分：标准 40，分层 80。失败和取消的任务会自动退还。

图片转 PPT API 让你的产品、脚本或工作流完成 EditablePPT 网页转换器所做的事。上传幻灯片图片、海报、截图或扫描页，EditablePPT 会识别文字、匹配样式、从背景中去除文字，并把剩余画面拆成图层。任务完成后，可以把一张或最多 20 张已转换的图片导出为同一个 PPTX 文稿。

识别、背景清理和图层拆分都需要时间，因此转换是异步的：标准模式约 1–2 分钟，分层模式约 3–5 分钟。发起任务后保存返回的 id 并轮询状态。请只在你自己的服务器上调用 API，不要放进公开网页或移动应用，因为每个请求都会消耗你账户的积分。

如何使用图片转 PPT API

  1. 1

    创建 API 密钥

    登录后打开“设置 > API 密钥”并创建密钥。密钥以 sk_ 开头，作为 Bearer 令牌发送。

  2. 2

    发起转换

    把图片原始字节 POST 到 /api/image-conversions，可选传入 quality 和 title。响应中包含任务 id。

  3. 3

    轮询并导出

    GET 任务直到 status 为 success，再把 id POST 到 /api/image-conversions/export 下载 .pptx 文件。

API 参考

接口与参数

除导出接口外，所有接口都返回包含 code、message 和 data 字段的 JSON。code 为 0 表示成功，其他值表示请求失败，原因见 message。导出接口直接返回 PPTX 文件。

身份验证

每个请求都要在 Authorization 请求头中带上 API 密钥。密钥属于你的账户并消耗其积分；如果泄露，请在“设置 > API 密钥”中撤销。

Authorization: Bearer sk_...

发起转换

请求体直接放图片原始字节，不要用 multipart 表单。查询参数：

  • quality：standard（默认）或 layered（五个景深图层）。其他值按标准模式处理。
  • refine=1：与 layered 一起使用，把按钮和小底板从大卡片中再拆出来。
  • title：可选，任务和导出文件的名称，最多 120 个字符。
POST https://editableppt.com/api/image-conversions

查询状态

返回任务及其当前状态。

  • status：pending、processing、success、failed 或 canceled。
  • progress：0–100，stage 表示当前步骤。
  • error：status 为 failed 时的原因，该任务的积分会退还。
GET https://editableppt.com/api/image-conversions?id=<ID>

导出 PPTX

发送 JSON 请求体，包含 ids（1–20 个成功任务的 id）和可选的 title。响应就是 .pptx 文件，每个任务一页，顺序与 ids 一致。

POST https://editableppt.com/api/image-conversions/export

{"ids":["<ID-1>","<ID-2>"],"title":"My deck"}

取消任务

停止仍在运行的任务并退还积分。用户放弃上传或你自己的超时到期时使用。

DELETE https://editableppt.com/api/image-conversions?id=<ID>

错误与限制

根据 HTTP 状态码决定是否重试。

  • 401：缺少 API 密钥或密钥无效。
  • 402：积分不足，充值后重试。
  • 400 或 413：不是 PNG/JPG、超过 2500 万像素或大于 20 MB。
  • 503：转换能力繁忙，稍后重试。

相关演示文稿工作流

图片转 PPT 分层 AIAI 把图片拆成文字、照片、图标、卡片和背景五个 PowerPoint 图层：可直接改字、隐藏或移动图层，并下载 PPTX。图片转可编辑 PPT把图片转换为可编辑 PPT：AI 将文字还原为可编辑文本框，并把视觉元素拆成独立图层；检查重建结果后下载 PPTX。让 PPT 可编辑PPT 改不了？解除只读、受保护的视图或“标记为最终”，或把全是图片的静态 PPT 在线转换为可编辑的文字和图片图层。

图片转 PPT API 常见问题

API 支持哪些图片格式和尺寸？

PNG 和 JPG/JPEG，每个请求不超过 20 MB、2500 万像素。每次转换发送一张图片，导出时再把多个已完成的任务合成一个文稿。

一次转换需要多久？

标准任务通常 1–2 分钟完成。分层任务约 3–5 分钟，开启精细拆分卡片层会再多几分钟。建议每 3–5 秒轮询一次，不要一直保持连接。

API 调用怎么计费？

与网页版使用同样的积分：标准每张 40，分层每张 80。任务开始时扣除，失败或取消时退还。积分不足的请求会返回 HTTP 402。

可以把多张图片合成一个 PowerPoint 吗？

可以。按想要的幻灯片顺序，把最多 20 个成功任务的 id 传给导出接口，就能得到一个 PPTX。

输出真的可以编辑吗？

识别出的文字是原生可编辑文字。视觉元素是带透明背景的独立图片，可以移动、缩放或删除。图表和表格不会重建为原生图表或表格，复杂页面在交付前请人工检查。