Appearance
基于网站链接生成PPT
适用场景
- 上传网站链接进行解析，根据解析结果生成PPT
步骤1：通过文件生成PPT
1.说明
- 接口描述：基于网站链接进行解析，根据解析的信息生成PPT制作任务，任务生成后，会立即返回一个唯一的任务ID，可以使用该任务ID来查询PPT的生成进度或预览结果
- 请求地址：https://saas.api.yoo-ai.com/apps/ppt-create-file
- 请求方式：POST
2.请求参数
Headers请求参数
- Token需要在韦尼克平台创建相关应用获取
| 名称 | 类型 | 必选 | 说明 | 示例值 |
|---|---|---|---|---|
| Authorization | string | 是 | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body请求参数
| 参数 | 类型 | 必须 | 说明 | 示例值 |
|---|---|---|---|---|
| file_url | string | 是 | 文件url | |
| user_name | string | 否 | PPT作者(为空默认值为尤小优) | 尤小优 |
| cover_id | string | 否 | 封面ID | FGRW43DF-1 |
3.请求示例
json
{
"file_url":"https://mp.weixin.qq.com/s/l6nG4-Snymi2psfTseaInQ",
"user_name":"尤小优",
"cover_id":"FGRW43DF-1"
}4.响应内容
| 名称 | 类型 | 参数描述 | 参数示例 |
|---|---|---|---|
| code | int | 状态码 | |
| msg | string | 返回信息 | |
| data | string | 数据体 | |
| data.id | array | 生成任务ID |
5.响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "a3vSWq37DWjcBEc3XuYGNadNZrZWYBjE"
}
}步骤2：获取PPT生成结果
1.说明
接口描述：通过之前生成任务的ID即可查询生成任务的进度，并获取对应PPT的预览图片。接口建议进行轮询，通过
status参数获取生成状态，通过data.state_description获取进度描述，预览图片逐步生成的请求方式：GET
2.请求参数
Header请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| AccessToken | string | 是 | AccessToken |
| AccessSecret | string | 是 | AccessSecret |
Query参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| id | string | 是 | 任务ID |
3.请求示例
json
{
"id":"acQdp8mesqQUmpQqkVHRMRffWyW7PqsW"
}4.响应内容
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| code | int | 状态码 | |
| msg | string | 返回信息 | |
| data | object | 数据体 | |
| data.id | string | 生成任务ID | |
| data.input_text | string | 请求任务query | |
| data.images_url | Array | PPT图片信息 | |
| data.images_url.url | string | PPT图片预览地址 | |
| data.images_url.time | string | PPT图片生成时间戳 | |
| data.ppt_title | string | PPT标题 | |
| data.page_count | int | 总页数 | |
| data.progress | int | 生成进度 | |
| data.status | int | 状态(1-进行中 2-已完成 3-生成失败) | |
| data.created_at | string | 任务开始时间 | |
| data.updated_at | string | 最后更新时间 | |
| data.state_description | string | 进度描述 | |
| data.process_url | string | web加载页面 |
5.响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "acQdp8mesqQUmpQqkVHRMRffWyW7PqsW",
"input_text": "生成一份网络安全ppt",
"user_client_ip": "192.168.10.1",
"images_url": [
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/7848bc234337d0934cb7229586a1bd53.png",
"time": 1697771030
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/9520959bea2d07d5f854fae1ba4eb655.png",
"time": 1697771030
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/560484f169f101b563c4dc52abe675d9.png",
"time": 1697771031
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/0b18abeccda8b7b3961263653a505aab.png",
"time": 1697771046
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/61c67562f1941f8a3213b597c1e51cb0.png",
"time": 1697771032
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/3a628745afb17cf34ab767fd16eeb498.png",
"time": 1697771040
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/c992895758fad2db14f8aa554a03e3bd.png",
"time": 1697771032
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/87505667281a520e84b0bba8c15c9872.png",
"time": 1697771044
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/0e20c8441c5a367f21d7d8638e6f6fb2.png",
"time": 1697771033
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/71abac6127183ca418f3fdffc7293d63.png",
"time": 1697771042
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/506bafd8b1138249dd5641b918939ed7.png",
"time": 1697771033
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/a5cdb2141c218819b1843f3f236a1f68.png",
"time": 1697771045
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/3fe19acc08e703315630351d6d4128fd.png",
"time": 1697771034
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/7408008b6b69d997d315eaef6382a877.png",
"time": 1697771044
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/357fc06954426a1c4e0ea65569447617.png",
"time": 1697771035
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/d649a2d74dc8d9628fe2c991a907ff57.png",
"time": 1697771042
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/6d738eb507225d210b43dc94242d07f3.png",
"time": 1697771035
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/56bbe4abf173fd632c9d3b2592f4aecb.png",
"time": 1697771044
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/6070a613b0024e728761ede0f693cb5e.png",
"time": 1697771036
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/da844cf3705c9a5d500cff5bca09a8cd.png",
"time": 1697771042
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/72e3ec1b4ffa32633ed0a6b58030e41e.png",
"time": 1697771037
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/754926389c6e39774c305802916f1223.png",
"time": 1697771045
},
{
"url": "https://image.yoojober.com/chatppt_business/2023-10/02738101d6a52dc6a381f4c0acd34b43.png",
"time": 1697771046
}
],
"ppt_title": "网络安全框架",
"page_count": 23,
"progress": 100,
"status": 2,
"created_at": "2023-10-20 11:03:45",
"updated_at": "2023-10-20 11:04:10",
"state_description": "生成已完成...",
"process_url": "https://aigc.yoo-ai.com/generateResults?urlKey=saas&generateID=acQdp8mesqQUmpQqkVHRMRffWyW7PqsW",
}
}步骤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="
}
}