Appearance
04-基于文件生成PPT
支持用户上传MarkDown、word、PDF、XMind、FreeMind、TXT 等文档文件,系统自动分析结构并生成对应的演示型 PPT。无需手动输入大纲,适合快速将现有文稿转化为 PPT 格式。
📌 使用前提
- 用户需准备格式规范的文档文件(MarkDown、word、PDF、XMind、FreeMind、TXT)
- 可选传入
cover_id
指定模板封面(如未传则随机选择)
🧭调用流程
1.📄文件生成PPT(/apps/ppt-create-file
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-create-file
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body参数(
application/json
)
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
file_url | string | Y | 文件URL | |
user_name | string | N | 作者名 | 尤小优 |
请求示例
json
{
"file_url":"https://saas.file.yoo-ai.com/20250115/f2025011-5150-7336-a5a3-c46772815112.doc",
"user_name":"作者名称"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.id | string | 任务ID |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw"
}
}
2. 🔄 获取生成PPT结果(/apps/ppt-result
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-result
- 请求方式: GET
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query参数
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID |
请求示例
json
{
"id":"rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.id | string | 任务id |
data.images_url | array | PPT中所有的图片URL和时间戳的数组 |
data.note_status | int | PPT备注状态(0-无备注,1-有备注) |
data.introduce | string | PPT的大纲 |
data.ppt_title | string | PPT标题 |
data.page_count | int | PPT的页数 |
data.progress | int | 生成进度,100表示已完成 |
data.status | int | 状态(1-进行中|2-已完成|3-生成失败) |
data.first_image_up_at | string | 第一张图片上传的时间 |
data.created_at | string | PPT创建的时间 |
data.updated_at | string | PPT最后更新的时间 |
data.state_description | string | 状态描述(生成已完成|正在生成演示内容) |
data.process_url | string | 生成进度的URL |
data.preview_url | string | PPT预览的URL,仅用于**【内部测试预览】** |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/tggalqdyx9qmy.png",
"time": 1748592131
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/6qr38zg0z68mw.png",
"time": 1748592131
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/6wau8fpbk22nd.png",
"time": 1748592132
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/dx88nihijqg2x.png",
"time": 1748592137
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/d256fhcv1ck8c.png",
"time": 1748592140
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/4xzrvzp590grp.png",
"time": 1748592140
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/vv6yztoanyofb.png",
"time": 1748592133
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/8czwumw4owpti.png",
"time": 1748592140
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/9j8axlh1wupor.png",
"time": 1748592141
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/7mcimv1yfhrc5.png",
"time": 1748592141
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/lpmac433jg7fi.png",
"time": 1748592134
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/ilbwb9fy0m0bp.png",
"time": 1748592141
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/xzox8q604fxxb.png",
"time": 1748592142
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/lhe3mju8m7i72.png",
"time": 1748592142
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/kvlm60d4ljttv.png",
"time": 1748592135
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/0k2vz4tx4mu9h.png",
"time": 1748592142
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/pyzix4b9lsipo.png",
"time": 1748592142
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/zr0218wtd3pm2.png",
"time": 1748592142
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/en97fpq80ws1g.png",
"time": 1748592136
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/zvndszlhzwjhy.png",
"time": 1748592143
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/9ygka4m8occnx.png",
"time": 1748592143
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/3p0v7uhzybakz.png",
"time": 1748592143
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/tcsryupyi1bp8.png",
"time": 1748592143
}
],
"note_status": 0,
"introduce": "ChatPPT:智能生成PPT的AI工具\r\n产品介绍与定位\r\nChatPPT概述\r\n智能生成技术\r\n一键智能体验\r\n产品介绍与定位\r\n自动生成幻灯片\r\n图像与语音转换\r\n机器学习模板学习\r\n产品介绍与定位\r\nChatPPT版本更新\r\n受众群体划分\r\n满足多样化需求\r\n产品介绍与定位\r\n智能对话式输入\r\n多样化的生成方式\r\n丰富的美化与导出功能\r\n产品介绍与定位\r\n高效便捷的制作过程\r\n个性化定制选项\r\n全面的功能满足用户需求\r\n",
"ppt_title": "ChatPPT:智能生成PPT的AI工具",
"page_count": 23,
"progress": 100,
"status": 2,
"first_image_up_at": "2025-05-30 16:02:11",
"created_at": "2025-05-30 16:01:24",
"updated_at": "2025-05-30 16:02:25",
"state_description": "生成已完成...",
"process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw",
"preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw"
}
}
3.⬇️PPT下载(/apps/ppt-download
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-download
- 请求方式: GET
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query参数
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID |
请求示例
json
{
"id":"cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.download_url | string | 下载链接 |
响应示例
4.json
{
"code": 200,
"msg": "success",
"data": {
"download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250530/v8henckb941vc.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-05-30T08%3A11%3A55Z%2F3600%2F%2F92b9e431a1e07d5e5cb02759aa45bb1511745ad3c6b8df64717cba6f7a995146"
}
}
4.🛠️PPT编辑器(/apps/ppt-editor
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-editor
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body参数(
application/json
)
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID | |
expire | string | Y | URL有效时间-秒 | 86400 |
请求示例
json
{
"id":"dNXxxaKDpSXFcGsufRyJ6w6nBxzmsyz6",
"expire":86400
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.url | string | 编辑器URL链接 |
data.expire_time | string | 链接到期时间 |
响应示例
- PPT文件已经渲染完成:
json
{
"code": 200,
"msg": "success",
"data": {
"url": "https://aigc.yoo-ai.com/editor?id=api%3Acuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e&token=HVMT7NWTGD7TWGRPPZT8TJFBRQUTEJJQ",
"expire_time": "2025-06-04 15:07:11"
}
}
- PPT正在生成中:
json
{
"code":204,
"msg":"请等待PPT生成完成...",
"data":{}
}