Appearance
07-MarkDown大纲生成PPT
通过提交符合特定结构的 Markdown 大纲,系统将智能识别并生成结构化 PPT 文档。
适合使用大模型生成PPT MarkDown大纲后,调用接口按照MarkDown大纲生成PPT。
🧭调用流程
1.📥PPT文档生成(/apps/ppt-create
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-create
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body参数(
application/json
)
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
text | string | Y | 输入的 Markdown 格式大纲(支持 # 、## 、### 、#### 、- 层级结构) | |
complex | int | N | PPT复杂度(1-简单 2-中等 3-复杂) | 1 |
font_name | string | N | 字体(黑体、宋体、仿宋、幼圆、楷书、隶书) | 黑体 |
language | string | N | en-US(英文),zh-TW(繁体中文) | 简体中文 |
color | string | N | PPT模板主题色(紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色) | 随机 |
user_name | string | N | 作者名 | 尤小优 |
ai_picture | bool | N | 是否使用AI生成图片 | False |
请求示例
json
{
"text":"# 酒店夏季高温防护与急救实战指南\n## 课程概述\n### 课程概述与核心价值\n- 背景:全球变暖加剧极端高温事件频发,酒店行业面临员工中暑、设备故障等运营风险\n- 核心价值:建立科学防护体系,降低运营风险,提升客户满意度\n- 课程特色:\n- 基于热生理学原理的防护机制设计\n- 融合国际酒店集团最佳实践案例\n- 提供可量化的风险评估工具\n## 模块一:高温危害机理与风险评估\n### 深度学习目标\n- 掌握热相关疾病的病理生理过程\n- 能运用WBGT指数进行环境风险评估\n- 建立酒店各区域风险等级矩阵\n### 详细内容要点\n#### 热应激反应机制\n- 人体热平衡方程式:M±R±C±K-E=S\n- 核心温度升高与器官损伤的临界阈值\n- 汗液电解质流失的生理影响\n#### 环境风险评估工具\n- WBGT监测仪的使用规范\n- 酒店风险区域划分标准:\n- 厨房(持续热辐射)\n- 室外岗位(直接暴晒)\n- 设备间(通风不良)\n#### 案例解析\n- 2022年迪拜某酒店员工热射病事件\n- 东京奥运会运动员村降温方案\n### 实践环节\n- 分组绘制酒店平面热风险地图\n- WBGT仪器实操演练\n## 模块二:三级防护体系构建\n### 深度学习目标\n- 掌握工程控制、管理控制、PPE的协同应用\n- 能制定分时段工作调度方案\n- 设计应急响应流程\n### 详细内容要点\n#### 工程控制措施\n- 空调系统负荷计算:\n- 冷负荷=建筑传热+人员散热+设备散热\n- 低成本改造方案:\n- 辐射冷却涂料反射率≥0.8\n- 遮阳装置角度计算\n#### 管理控制策略\n- 工作休息周期:\n- 温度32℃时每60分钟休息15分钟\n- 温度35℃时每45分钟休息20分钟\n- 水分补充方案:\n- 每小时500ml含电解质饮料\n- 尿液比色卡监测法"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.id | string | 任务 ID |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
},
"request_id": "YOO-saas-api688b0f65f34b8"
}
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":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
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": "uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/uop6ames6ql43.png",
"time": 1753943921
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/uge9680le4shj.png",
"time": 1753943922
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/b6o6bvhsswool.png",
"time": 1753943922
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/4e0afpmfuam05.png",
"time": 1753943929
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/oysziq0p2ru3w.png",
"time": 1753943923
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/z8wqv6k3nog2i.png",
"time": 1753943930
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/96x5kims4f3v7.png",
"time": 1753943930
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/91e7yeemlqnc3.png",
"time": 1753943931
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/keskukknzjyvq.png",
"time": 1753943924
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/gcmzsmkucpnt0.png",
"time": 1753943931
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/huazfwnt4kr8t.png",
"time": 1753943932
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250731/8tx0n6cqizus8.png",
"time": 1753943932
}
],
"note_status": 0,
"introduce": "酒店夏季高温防护与急救实战指南\r\n课程概述\r\n课程概述与核心价值\r\n课程概述\r\n深度学习目标\r\n详细内容要点\r\n实践环节\r\n课程概述\r\n深度学习目标\r\n详细内容要点\r\n",
"ppt_title": "酒店夏季高温防护与急救实战指南",
"page_count": 12,
"progress": 100,
"status": 2,
"first_image_up_at": "2025-07-31 14:38:41",
"created_at": "2025-07-31 14:38:30",
"updated_at": "2025-07-31 14:38:53",
"state_description": "生成已完成...",
"process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS",
"preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
},
"request_id": "YOO-saas-api688b0f9f9355a"
}
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":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
data.download_url | string | 下载链接 |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250731/821pv09w3hf0v.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-07-31T06%3A44%3A03Z%2F3600%2F%2F17f586605d682eb7e0f266cb12fbd51817dc52565524040b0661fe4fdd3175fc"
},
"request_id": "YOO-saas-api688b10b310223"
}
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":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS",
"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%3AuXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS&token=ZFWDC3G6TEMAHCBNS73U4AAYBKZC6RCC",
"expire_time": "2025-08-01 14:44:51"
},
"request_id": "YOO-saas-api688b10e37b51c"
}
- PPT正在生成中:
json
{
"code":204,
"msg":"请等待PPT生成完成...",
"data":{}
}