08-生成PPT并直达编辑器

在创建 PPT 任务的同时，系统会立即返回一个 编辑器链接。
用户点击该链接即可进入在线编辑器，页面会自动异步渲染生成内容。
渲染完成后，编辑器将直接展示完整的 PPT，无需用户额外调用查询接口。

🧭调用流程

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

接口说明

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

请求参数

Header

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

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

Body参数（application/json）

参数名	类型	必填	描述	默认值
text	string	Y	请求生成PPT文本
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
report	bool	N	true - 编辑器异步渲染，获取任务ID后可以直接调用【步骤4-PPT编辑器】，会直接进入生成渲染页面。【⚠️注意】使用异步渲染后，获取结果接口将不会再返回图片数据。	false

请求示例

json

{
    "text":"生成一个人工智能PPT",
    "complex":1,
    "font_name":"幼圆",
    "language":"zh-TW",
    "color":"蓝色",
    "user_name":"张三",
    "report":true,
    "ai_picture"：false
}

响应参数

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

响应示例

json

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

2.🛠️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
report	bool	N	true - 获取异步渲染编辑器链接	false

请求示例

json

{
    "id":"dNXxxaKDpSXFcGsufRyJ6w6nBxzmsyz6",
    "expire":86400,
    "report":true
}

响应参数

参数名	类型	描述
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":{}
}

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

需要通过这个接口获取生成状态，通过生成状态去判断是否能获取PPT下载链接

接口说明

接口地址：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

https://saas.api.yoo-ai.com/apps/ppt-result?id=YsHkZZxxxxxxXR3rXwS

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.id	string	任务id
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.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": "hHJ9F4fqVpqBk3fwNKHyyb5qhPc5xdpQ",
        "images_url": [],
        "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",
        "ppt_title": "人工智能技术发展与应用趋势",
        "page_count": 18,
        "progress": 100,
        "status": 2,
        "first_image_up_at": null,
        "created_at": "2025-09-15 11:25:12",
        "updated_at": "2025-09-15 11:38:31",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=hHJ9F4fqVpqBk3fwNKHyyb5qhPc5xdpQ",
        "preview_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=hHJ9F4fqVpqBk3fwNKHyyb5qhPc5xdpQ"
    },
    "request_id": "YOO-saas-api68c78cd17b594"
}

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

通过步骤三得到"status": 2时即可获取下载链接

接口说明

接口地址：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-05-29T09%3A08%3A49Z%2F3600%2F%2F9b2a90dc43d2d1158a5da74f889c529a91a672069925ce970b61b53fe4757abf"
    }
}

1.接入指南

2.可选功能

3.PPT生成方案

08-生成PPT并直达编辑器

🧭调用流程

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

08-生成PPT并直达编辑器 ​

🧭调用流程 ​

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

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

08-生成PPT并直达编辑器

🧭调用流程

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例