AI PPT 生成 API

输入大纲或主题，生成可编辑的企业级演示文稿。浩瀚 AI PPT 同款能力接口化。

POST /v1/ppt v1 免费额度 · 申请制

快速开始

替换 YOUR_KEY 为你申请到的 Key，直接发起首个请求：

# 1. 提交生成任务（异步）
curl -X POST https://skyaibi.com/v1/ppt \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"outline": "企业数据资产入表实操", "pages": 10, "style": "tech-blue"}'

# 响应
{"code": 0, "data": {"task_id": "ppt_9f3a", "status": "queued", "eta_sec": 45}}

# 2. 轮询任务结果
curl https://skyaibi.com/v1/ppt/ppt_9f3a -H "X-API-Key: YOUR_KEY"

# 响应（完成后）
{"code": 0, "data": {"status": "done", "download_url": "https://skyaibi.com/dl/ppt_9f3a.pptx"}}

示例参数为示意，正式字段与枚举值以 OpenAPI 3.1 规范为准（下方可下载，可直接导入 Apifox / Postman）。

鉴权与调用约束

所有请求携带请求头 X-API-Key，在申请开通后由系统下发
Key 与免费额度绑定申请主体，请勿在客户端代码中明文暴露
限频规则：免费额度内默认 10 次/分钟，超限返回 429
生成结果为原生可编辑 .pptx，下载地址 24 小时内有效

接口清单

方法	路径	说明
POST	/v1/ppt	提交 PPT 生成任务，返回 task_id
GET	/v1/ppt/{task_id}	查询任务状态与下载地址
GET	/v1/ppt/styles	获取可用模板风格列表

错误码

code	含义	处理建议
40001	无效 API Key	检查 X-API-Key 是否正确、是否已开通
40002	免费额度用尽	升级套餐或联系商务扩容
422	参数缺失/不合法	按错误信息中 field 字段修正请求体
429	触发限频	降低调用频率，参考 Retry-After 响应头
500	服务内部错误	稍后重试，持续失败请联系我们

规范与申请

下载 OpenAPI 3.1 规范（JSON）申请 API Key

FAQ

常见问题

AI PPT 生成 API 怎么计费？

提供免费额度，申请制开通；超出后按调用量阶梯计费，B 端项目可打包进数智化服务合同。

生成一份 PPT 需要多长时间？

异步任务模式：提交返回 task_id，一般 1-3 分钟内轮询可取到 .pptx 下载地址。

支持私有化部署吗？

支持。数据不出内网的政企场景可私有化部署浩瀚 AI PPT，接口层封装按需评估。