Skip to content

07-MarkDown大纲生成PPT

通过提交符合特定结构的 Markdown 大纲,系统将智能识别并生成结构化 PPT 文档。

适合使用大模型生成PPT MarkDown大纲后,调用接口按照MarkDown大纲生成PPT。

🧭调用流程

1.📥PPT文档生成(/apps/ppt-create

接口说明

  • 接口地址:https://saas.api.yoo-ai.com/apps/ppt-create
  • 请求方式: POST

请求参数

韦尼克平台创建应用获取,刷新Token接口

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx
  • Body参数(application/json

参数名类型必填描述默认值
textstringY输入的 Markdown 格式大纲(支持 ##########- 层级结构)
complexintNPPT复杂度(1-简单 2-中等 3-复杂)1
font_namestringN字体(黑体、宋体、仿宋、幼圆、楷书、隶书)黑体
languagestringNen-US(英文),zh-TW(繁体中文)简体中文
colorstringNPPT模板主题色(紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色)随机
user_namestringN作者名尤小优
ai_pictureboolN是否使用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- 尿液比色卡监测法"
}

响应参数

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.idstring任务 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

请求参数

韦尼克平台创建应用获取,刷新Token接口

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx
  • Query参数

参数名类型必填描述默认值
idstringY任务ID

请求示例

json
{
    "id":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
}

响应参数

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.idstring任务id
data.images_urlarrayPPT中所有的图片URL和时间戳的数组
data.note_statusintPPT备注状态(0-无备注,1-有备注)
data.introducestringPPT的大纲
data.ppt_titlestringPPT标题
data.page_countintPPT的页数
data.progressint生成进度,100表示已完成
data.statusint状态(1-进行中|2-已完成|3-生成失败)
data.first_image_up_atstring第一张图片上传的时间
data.created_atstringPPT创建的时间
data.updated_atstringPPT最后更新的时间
data.state_descriptionstring状态描述(生成已完成|正在生成演示内容)
data.process_urlstring生成进度的URL
data.preview_urlstringPPT预览的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

请求参数

韦尼克平台创建应用获取,刷新Token接口

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx
  • Query参数

参数名类型必填描述默认值
idstringY任务ID

请求示例

json
{
    "id":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS"
}

响应参数

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.download_urlstring下载链接

响应示例

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

请求参数

韦尼克平台创建应用获取,刷新Token接口

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx
  • Body参数(application/json

参数名类型必填描述默认值
idstringY任务ID
expirestringYURL有效时间-秒86400

请求示例

json
{
    "id":"uXpRRS5gkQF5R8NfVC8g8JFQ5gG6ENVS",
    "expire":86400
}

响应参数

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.urlstring编辑器URL链接
data.expire_timestring链接到期时间

响应示例

  • 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":{}
}