02-逐步生成PPT

🧭调用流程

1.📝AI标题大纲生成（`/apps/ppt-structure`）

接口说明

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

请求参数

Header

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

Body参数（application/json）

参数名	类型	必填	描述	默认值
title	string	Y	PPT标题	网络安全大赛
text	string	Y	PPT描述	生成一份网络安全PPT
theme	string	Y	PPT主题	网络安全主题

请求示例

json

{
    "title":"网络安全大赛",
    "theme":"网络安全主题",
    "text":"生成一份网络安全PPT"
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
title	string	PPT标题
catalogs	Array	大纲数组

参数名	类型	描述
catalog	string	一级标题
sub_catalog	Array	二级标题

响应示例

json

{
    "code": 200,
    "msg": "success",
    "data": {
        "title": "网络安全大赛",
        "catalogs": [
            {
                "catalog": "网络安全威胁分析",
                "sub_catalog": [
                    "新型网络攻击手段剖析",
                    "网络钓鱼与社交工程防范",
                    "勒索软件与数据保护策略"
                ]
            },
            {
                "catalog": "安全防护体系建设",
                "sub_catalog": [
                    "防火墙与入侵检测系统部署",
                    "加密技术与数据备份策略",
                    "安全漏洞扫描与应急响应"
                ]
            },
            {
                "catalog": "网络安全人才培养",
                "sub_catalog": [
                    "网络安全专业教育体系构建",
                    "实战化网络安全人才培养",
                    "网络安全意识普及与提升"
                ]
            },
            {
                "catalog": "法律法规与合规要求",
                "sub_catalog": [
                    "网络安全法律法规解读",
                    "企业网络安全合规实践",
                    "个人信息保护与数据跨境流动"
                ]
            },
            {
                "catalog": "网络安全赛事解析",
                "sub_catalog": [
                    "网络安全大赛赛题类型分析",
                    "攻防演练与实战技巧分享",
                    "网络安全赛事对行业的推动作用"
                ]
            },
            {
                "catalog": "未来网络安全趋势",
                "sub_catalog": [
                    "物联网与5G时代的网络安全",
                    "人工智能在网络安全中的应用",
                    "网络安全国际合作与共同发展"
                ]
            }
        ]
    }
}

2.🎨AI模板生成方案（`/apps/ppt-cover`）

接口说明

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

请求参数

Header

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

Body参数（application/json）

参数名	类型	必填	描述	默认值
title	string	Y	PPT标题
count	int	N	返回模板个数，数量范围(0,4]	1
user_name	string	N	作者	尤小优
color	string	N	模板主题色，取值为["紫色","红色","橙色","黄色","绿色","青色","蓝色","粉色"]
style	string	N	模板风格，取值为["科技风","商务风","小清新","极简风","中国风","可爱卡通"]
size	string	N	预览封面图片大小（1=480 * 270；2=960 * 540；3=1920 * 1080）	3

请求示例

json

{
    "title":"网络安全",
    "count":1,
    "user_name":"张三",
    "color":"蓝色",
    "style":"商务风",
    "size":"3"
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.cover_image	string	封面预览图
data.cover_id	string	封面ID
data.color	string	封面主题色
data.color_list	Array	配色列表

响应示例

json

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "cover_image": "http://file.static.yoojober.cn/temp/ppt/images/20250530/83c06607c4fc45cf9cc112729ca87905.png",
            "cover_id": "6JCxtc-0",
            "color": "蓝色",
            "color_list": [
                "#001630",
                "#FFFFFF",
                "#FFFFFF",
                "#1F2631",
                "#2385FD",
                "#00D4FF",
                "#3f8efc",
                "#B5CCFF",
                "#bfd7ff",
                "#e2fdff",
                "#2385FD",
                "#00D4FF"
            ]
        }
    ]
}

3.📥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）

参数名	类型	必填	描述	默认值
cover_id	string	N	模板ID，从“步骤二”中获取
font_name	string	N	字体（黑体、宋体、仿宋、幼圆、楷书、隶书）	黑体
language	string	N	en-US（英文），zh-TW（繁体中文）	简体中文
ai_picture	bool	N	是否使用AI生成图片	False
custom_data	object	Y	大纲参数，从步骤一中获取，具体看custom_data表格

参数	类型	必须	说明
title	string	Y	标题
catalogs	array	N	大纲，具体看catalogs表格

参数	类型	必须	说明
catalog	string	Y	一级大纲
sub_catalog	array (string)	N	该一级大纲下的二级大纲可以为空，但要尽量保证所有一级大纲下都有或者都没有二级大纲

请求示例

json

{
    "cover_id": "6JCxtc-0",
    
    "custom_data":{
        "title": "网络安全大赛",
        "catalogs": [
            {
                "catalog": "网络安全威胁分析",
                "sub_catalog": [
                    "新型网络攻击手段剖析",
                    "网络钓鱼与社交工程防范",
                    "勒索软件与数据保护策略"
                ]
            },
            {
                "catalog": "安全防护体系建设",
                "sub_catalog": [
                    "防火墙与入侵检测系统部署",
                    "加密技术与数据备份策略",
                    "安全漏洞扫描与应急响应"
                ]
            },
            {
                "catalog": "网络安全人才培养",
                "sub_catalog": [
                    "网络安全专业教育体系构建",
                    "实战化网络安全人才培养",
                    "网络安全意识普及与提升"
                ]
            },
            {
                "catalog": "法律法规与合规要求",
                "sub_catalog": [
                    "网络安全法律法规解读",
                    "企业网络安全合规实践",
                    "个人信息保护与数据跨境流动"
                ]
            },
            {
                "catalog": "网络安全赛事解析",
                "sub_catalog": [
                    "网络安全大赛赛题类型分析",
                    "攻防演练与实战技巧分享",
                    "网络安全赛事对行业的推动作用"
                ]
            },
            {
                "catalog": "未来网络安全趋势",
                "sub_catalog": [
                    "物联网与5G时代的网络安全",
                    "人工智能在网络安全中的应用",
                    "网络安全国际合作与共同发展"
                ]
            }
        ]
    }
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.id	string	任务ID

响应示例

json

{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "B3Auv7bBFhuRQR2bMDCFbZwPjJ9c3252"
    }
}

4.🔄获取生成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":"cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
}

响应参数

参数名	类型	描述
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": "B3Auv7bBFhuRQR2bMDCFbZwPjJ9c3252",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/3c7ktusq6zxj0.png",
                "time": 1748578483
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/uo3q1crz03upr.png",
                "time": 1748578495
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/klfce6iomx8t1.png",
                "time": 1748578496
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/3ca3779k5y1h6.png",
                "time": 1748578506
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/gkx6qqzgvpkgc.png",
                "time": 1748578506
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/jckmt64vv1y9y.png",
                "time": 1748578506
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/xjcno46kp9at3.png",
                "time": 1748578498
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/lcb8w63216t9t.png",
                "time": 1748578506
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/m6isbntz5t85r.png",
                "time": 1748578507
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/c8y4wsn8b5045.png",
                "time": 1748578507
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/ku1hltk8a6ovl.png",
                "time": 1748578499
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/8njepu9mbcmfe.png",
                "time": 1748578507
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/tf8339rts3s6h.png",
                "time": 1748578507
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/8dwy88fdj9wsd.png",
                "time": 1748578507
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/ye4gndir3qaj8.png",
                "time": 1748578499
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/nei84ja43d43z.png",
                "time": 1748578508
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/hhe0bf2dhmkpk.png",
                "time": 1748578508
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/4gmynk0frhtjv.png",
                "time": 1748578509
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/447f9t2tzvtv7.png",
                "time": 1748578500
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/79hdrfzs9db69.png",
                "time": 1748578509
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/8tsihlxqlzf8o.png",
                "time": 1748578509
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/rvn6wo6sq9xeh.png",
                "time": 1748578509
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/8cdvjid42hkk4.png",
                "time": 1748578501
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/yzi4fuqo20ryr.png",
                "time": 1748578510
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/30elm73jbxyaw.png",
                "time": 1748578510
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/laosn9bckjk2f.png",
                "time": 1748578510
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/i7xya327fd4d1.png",
                "time": 1748578511
            }
        ],
        "note_status": 0,
        "introduce": "网络安全大赛\r\n网络安全威胁分析\r\n新型网络攻击手段剖析\r\n网络钓鱼与社交工程防范\r\n勒索软件与数据保护策略\r\n网络安全威胁分析\r\n防火墙与入侵检测系统部署\r\n加密技术与数据备份策略\r\n安全漏洞扫描与应急响应\r\n网络安全威胁分析\r\n网络安全专业教育体系构建\r\n实战化网络安全人才培养\r\n网络安全意识普及与提升\r\n网络安全威胁分析\r\n网络安全法律法规解读\r\n企业网络安全合规实践\r\n个人信息保护与数据跨境流动\r\n网络安全威胁分析\r\n网络安全大赛赛题类型分析\r\n攻防演练与实战技巧分享\r\n网络安全赛事对行业的推动作用\r\n网络安全威胁分析\r\n物联网与5G时代的网络安全\r\n人工智能在网络安全中的应用\r\n网络安全国际合作与共同发展\r\n",
        "ppt_title": "网络安全大赛",
        "page_count": 27,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2025-05-30 12:14:43",
        "created_at": "2025-05-30 12:14:27",
        "updated_at": "2025-05-30 12:15:17",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=B3Auv7bBFhuRQR2bMDCFbZwPjJ9c3252",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=B3Auv7bBFhuRQR2bMDCFbZwPjJ9c3252"
    }
}

5.⬇️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	下载链接

响应示例

json

{
    "code": 200,
    "msg": "success",
    "data": {
        "download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250529/0i2guz0xzgz3y.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-05-30T04%3A18%3A29Z%2F3600%2F%2F656d147a4b8e7ab93a6b617e094d55b861382cbc30743f650fa9546eb8c46b18"
    }
}

6.🛠️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":{}
}

02-逐步生成PPT ​

🧭调用流程 ​

1.📝AI标题大纲生成（/apps/ppt-structure） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

2.🎨AI模板生成方案（/apps/ppt-cover） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

3.📥PPT文档生成（/apps/ppt-create） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

4.🔄获取生成PPT结果（/apps/ppt-result） ​

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

5.⬇️PPT下载（/apps/ppt-download） ​

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

6.🛠️PPT编辑器（/apps/ppt-editor） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

02-逐步生成PPT

🧭调用流程

1.📝AI标题大纲生成（`/apps/ppt-structure`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

2.🎨AI模板生成方案（`/apps/ppt-cover`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

3.📥PPT文档生成（`/apps/ppt-create`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

4.🔄获取生成PPT结果（`/apps/ppt-result`）

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

5.⬇️PPT下载（`/apps/ppt-download`）

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

6.🛠️PPT编辑器（`/apps/ppt-editor`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例