PPT美化创建任务
更新时间：2026-06-18
POST
https://qianfan.baidubce.com/v2/tools/ppt_beautify_create
PPT 美化服务采用异步任务机制。用户通过创建任务接口提交 PPT 文件 URL，系统异步完成 AI 美化处理； 查询任务接口获取美化后的 PPT 文件 URL 及任务状态。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
pptx_url
string
待美化的 PPTX 文件 URL，必须为 http/https 协议，长度不超过 2048 字符
必选
style_images
string
风格参考图片 URL 列表，每个 URL 须为 http/https 协议且不超过 2048 字符；最多 20 张
可选
示例代码
请求示例
curl --request POST \
--url https://qianfan.baidubce.com/v2/tools/ppt_beautify_create \
--header 'Authorization: Bearer xxxxxx' \
--header 'content-type: application/json' \
--data '{
"pptx_url": "https://image0.bj.bcebos.com/0000f6cd-0653-11f1-ae84-225edd65cbbf.pptx",
"style_images": [
"https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/9_wennuanchunri/cover_0-1774598523033.png"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
错误码，成功：0
可选
show_msg
string
状态描述
可选
requestId
string
请求唯一ID
可选
server_time
integer
服务器时间戳
可选
data
object {1}
返回结果内容
可选
显示子属性
隐藏子属性
task_id
string
任务ID
可选
响应示例
{
"request_id": 407121474338031552,
"show_msg": "",
"server_time": 1781598347,
"data": {
"task_id": "1c440d02-f79d-4da4-9293-19cf4ed561b5"
},
"requestId": "",
"code": "0"
}参数说明
pptx_url：待美化的 PPT 文件下载地址，系统会下载此文件进行解析和美化。需确保该 URL 在服务端可访问。
style_images：风格参考图片，AI 将参考这些图片的视觉风格对 PPT 进行美化。可传空数组 [] 表示不指定风格。
参考风格（以下是参考风格图片，开发者可按需自取）:
- 诗词里温暖春日：https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/9_wennuanchunri/cover_0-1774598523033.png
- 极简美学：https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/6_jijianmeixue/cover_0-1774598361525.png
- 户外雪山攀登指南：https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/8_huwaixueshan/cover_0-1774598465950.png
- 水墨古典艺术精粹：https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/3_shuimogudian/cover_0-1774598078748.png
- 可爱卡通形象设计：https://edu-wenku.bdimg.com/v1/pc/contract/pptstyletpl/5_keaikatong/cover_0-1774598301344.png
错误码说明
| code | 描述 | 触发场景 |
|---|---|---|
| 0 | 成功 | 请求正常处理 |
| 40001 | 参数验证失败 | pptx_url 为空/格式非法，style_images 超过 20 张或 URL 非法，task_id 为空，appid为空 |
| 40003 | APPUID不能为空 | 未传 APP_UID 请求头 |
| 40004 | 任务不存在 | task_id 不存在，或 appid/APP_UID 与创建时不一致 |
| 50001 | PPTX 文件解析失败 | 源 PPT 文件无法解析 |
| 50002 | PPT 美化服务异常，请稍后重试 | AI Agent 调用失败 |
| 50003 | 文件转码失败，请稍后重试 | pptx2image 或 html2pptx 转码服务失败 |
| 50004 | 会话分配失败，请稍后重试 | ID 分配服务失败 |
| 50005 | 系统内部错误，请稍后重试 | 其他系统错误 |
| 50006 | 内容命中风控，无法处理 | 内容安全审核未通过 |
评价此篇文章