Appearance
描述一键生成PPT
适用场景
- 仅需提供文字描述，即可按照文字描述一键生成PPT，支持设置PPT大纲的复杂度和封面作者名
步骤1：请求生成PPT文档
1.说明
接口描述：接收用户输入的PPT信息（如PPT标题、大纲丰富度、封面ID等），根据这些信息生成PPT制作任务，任务生成后，会立即返回一个唯一的任务ID，可以使用该任务ID来查询PPT的生成进度或预览结果
请求方式：POST
2.请求参数
Headers
- Token需要在韦尼克平台创建相关应用获取
| 名称 | 类型 | 必选 | 说明 | 示例值 |
|---|---|---|---|---|
| Authorization | string | 是 | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body请求参数
| 参数 | 类型 | 备注 | 必选 | 默认值 |
|---|---|---|---|---|
| text | string | 请求生成PPT-query | Y | |
| complex | int | PPT复杂度（1-简单 2-中等 3-复杂） | N | 1 |
| user_name | string | 作者名 | N | 尤小优 |
3.请求示例
json
{
"text":"生成一份关于网络安全的PPT",
"complex":"1",
"user_name":"尤小优",
}4.响应内容
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| code | int | 状态码 | |
| msg | string | 返回状态码 | |
| data | object | 数据体 | |
| data.id | string | 任务ID |
5.响应示例
json
{
"code":"200",
"msg":"success",
"data":{
"id":"acQdp8mesqQUmpQqkVHRMRffWyW7PqsW"
}
}步骤2：获取PPT生成结果
1.说明
接口描述：通过之前生成任务的ID即可查询生成任务的进度，并获取对应PPT的预览图片。接口建议进行轮询，通过
status参数获取生成状态，通过data.state_description获取进度描述，预览图片逐步生成的请求方式：GET
2.请求参数
Headers
- Token需要在韦尼克平台创建相关应用获取
| 名称 | 类型 | 必选 | 说明 | 示例值 |
|---|---|---|---|---|
| Authorization | string | 是 | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| id | string | 是 | 任务ID |
3.请求示例
json
{
"id":"acQdp8mesqQUmpQqkVHRMRffWyW7PqsW"
}4.响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| code | int | 响应状态码，200表示请求成功 |
| msg | string | 响应消息，"success"表示请求成功 |
| data | object | 包含PPT相关信息的数据对象 |
| id | string | 任务ID |
| images_url | array | 包含PPT中所有图片的URL和时间戳的数组 |
| images_url.url | string | PPT图片预览地址 |
| images_url.time | string | PPT图片生成时间戳 |
| note_status | int | PPT备注状态，0-无备注，1-有备注 |
| introduce | string | PPT的大纲 |
| ppt_title | string | PPT的标题 |
| page_count | int | PPT的页数 |
| progress | int | 生成进度，100表示已完成 |
| status | int | 状态(1-进行中 2-已完成 3-生成失败) |
| first_image_up_at | string | 第一张图片上传的时间 |
| created_at | string | PPT创建的时间 |
| updated_at | string | PPT最后更新的时间 |
| state_description | string | 状态描述，"生成已完成"、"正在生成演示内容" |
| process_url | string | 生成进度的URL |
| preview_url | string | PPT预览的URL |
5.响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "K7zx7Jb2y7c7AyHCPrsVG6cgpJK6HvFA",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c90b92dcc.png",
"time": 1734592779
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c915af2ec.png",
"time": 1734592790
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c91684fe5.png",
"time": 1734592790
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c92c0f38d.png",
"time": 1734592812
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c92d1c2a6.png",
"time": 1734592813
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c92e2ee0d.png",
"time": 1734592814
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c9185bb98.png",
"time": 1734592792
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c92f5f359.png",
"time": 1734592815
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c9305e9c2.png",
"time": 1734592816
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c93174fb5.png",
"time": 1734592817
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c91a5aad2.png",
"time": 1734592794
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c932a1606.png",
"time": 1734592818
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c9338bb15.png",
"time": 1734592820
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c9349b0ff.png",
"time": 1734592820
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c91c17976.png",
"time": 1734592796
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c935bf07f.png",
"time": 1734592821
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c9369a528.png",
"time": 1734592822
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c937d1686.png",
"time": 1734592824
},
{
"url": "https://file.static.yoojober.cn/chatppt/20241219/6763c93844a3d.png",
"time": 1734592824
}
],
"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",
"ppt_title": "网络攻击类型及防御策略",
"page_count": 19,
"progress": 100,
"status": 2,
"first_image_up_at": "2024-12-19 15:19:39",
"created_at": "2024-12-19 15:19:15",
"updated_at": "2024-12-19 15:20:26",
"state_description": "生成已完成...",
"process_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=K7zx7Jb2y7c7AyHCPrsVG6cgpJK6HvFA",
"preview_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=K7zx7Jb2y7c7AyHCPrsVG6cgpJK6HvFA"
}
}步骤3：获取PPT下载地址
1.说明
| 接口描述 | 获取PPT下载链接 | ||
|---|---|---|---|
| 请求地址 | https://saas.api.yoo-ai.com/apps/ppt-download | 请求方式 | GET |
2.请求参数
Headers
- Token需要在韦尼克平台创建相关应用获取
| 名称 | 类型 | 必选 | 说明 | 示例值 |
|---|---|---|---|---|
| Authorization | string | 是 | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
query参数
| 参数 | 类型 | 必须 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 是 | PPT生成ID | |
| type | string | 是 | pptx | 下载的文件格式 |
3.请求示例
- 下载PPTX格式示例：
{
"id":"BTs3qWzWaFpjRbyz5ZGfAR6SMnSPYyyB",
"type":"pptx"
}4.响应内容
| 名称 | 类型 | 参数描述 | 参数示例 |
|---|---|---|---|
| code | int | 状态码 | |
| msg | string | 描述消息 | |
| data | object | 数据体 | |
| data.download_url | string | 下载链接 |
5.响应示例
json
{
"code": 200,
"msg": "success",
"data":{
"download_url":"https://download.yoojober.com/chatppt_business/2024-06/86b26b64cb6ebf7565523c9192f467a2.pptx?e=1717675120&token=8_2qFlGEVQZPpFvHdGR6gg2t9A9QZfWT9wwTl92s:cbgbknWpC2QuLzn2zqFDHjifCA4="
}
}