06-更换已有PPT的模板

⚠️ 使用本功能前，必须已经通过生成方式成功创建过 PPT，并获取任务ID。
该接口支持为已生成的PPT重新应用新模板，包括字体、过渡动画等内容样式的统一替换。无需重新填写内容，仅通过任务ID即可一键切换风格，适用于快速迭代、美化或品牌统一需求。
📌 使用前提
需已成功调用过任意生成类接口（如 /apps/ppt-create），并获得有效的任务 ID。
原始内容结构会保持不变，仅视觉模板样式变化。

🧭调用流程

1.📥通过task_id重新生成ppt（`/apps/ppt-create-task`）

接口说明

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

请求参数

Header

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

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

Body参数（application/json）

参数名	类型	必填	描述	默认值
id	string	Y	任务ID
cover_id	string	Y	模板ID，通过可选功能【04-PPT模板封面预览】获取
transition	string	N	PPT动画[1-使用动画 2-不使用动画]	2
font_name	string	N	字体，取值：[黑体、宋体、仿宋、幼圆、楷体、隶书]

请求示例

json

{
    "id":"ysBhyfJ8TXFmjeVUu8zXNSezmMpXMyhj",
    "cover_id":"v2eRnb-1",
    "font_name":"幼圆",
    "transition":"1"
}

响应参数

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

响应示例

json

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

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

接口说明

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

请求参数

Header

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

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

Query参数

参数名	类型	必填	描述	默认值
id	string	Y	任务ID

请求示例

json

{
    "id":"FDgg4epcJjJSRWPenhKC5NJj2uDWsucQ"
}

响应参数

参数名	类型	描述
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": "FDgg4epcJjJSRWPenhKC5NJj2uDWsucQ",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/0106dobn68iox.png",
                "time": 1749785397
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/4hrgomodi5ozx.png",
                "time": 1749785398
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/tzv1tktx7q67k.png",
                "time": 1749785398
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/jcmcej0okiy9k.png",
                "time": 1749785400
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/a2nlmqs62pjj0.png",
                "time": 1749785404
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/ifzt29l0atmtz.png",
                "time": 1749785404
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/j3ggxonaxnnlo.png",
                "time": 1749785398
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/lvet9dc7q4xfe.png",
                "time": 1749785404
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/nns8z7k5pz7e8.png",
                "time": 1749785404
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/f0bofcxe6zqs6.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/ndw5obr8ua4im.png",
                "time": 1749785399
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/bck8jhcvjsgcd.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/qjjwvcdw6qqf7.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/nvqsbq14hb5rq.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/x67r1mxolkjph.png",
                "time": 1749785399
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/rjyy82y8ie99k.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/npg5m19pln115.png",
                "time": 1749785405
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/zxa3mhpbzpfkl.png",
                "time": 1749785406
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/6unmtpsxdk99c.png",
                "time": 1749785399
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/pn3o8miiwi89u.png",
                "time": 1749785406
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/izxnf8lptanvz.png",
                "time": 1749785406
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/138f4ak5xmrj7.png",
                "time": 1749785406
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250613/lx4du0oq3ncmd.png",
                "time": 1749785407
            }
        ],
        "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",
        "ppt_title": "人机协同：安全意识决定防线强度",
        "page_count": 23,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2025-06-13 11:29:57",
        "created_at": "2025-06-13 11:29:50",
        "updated_at": "2025-06-13 11:30:09",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=FDgg4epcJjJSRWPenhKC5NJj2uDWsucQ",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=FDgg4epcJjJSRWPenhKC5NJj2uDWsucQ"
    }
}

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

接口说明

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

请求参数

Header

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

参数名	类型	描述	示例值
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-06-13T03%3A33%3A26Z%2F3600%2F%2Fdd7b9917c2c28ad71e771796b881612d6f4ed43c34a54bffde949fbecc9d2e51"
    }
}

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

接口说明

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

请求参数

Header

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

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

Body参数（application/json）

参数名	类型	必填	描述	默认值
id	string	Y	任务ID
expire	string	Y	URL有效时间-秒	86400

请求示例

json

{
    "id":"cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e",
    "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":{}
}

06-更换已有PPT的模板

📌 使用前提

🧭调用流程

1.📥通过task_id重新生成ppt（`/apps/ppt-create-task`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

06-更换已有PPT的模板 ​

📌 使用前提 ​

🧭调用流程 ​

1.📥通过task_id重新生成ppt（/apps/ppt-create-task） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

06-更换已有PPT的模板

📌 使用前提

🧭调用流程

1.📥通过task_id重新生成ppt（`/apps/ppt-create-task`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例