Appearance
一句话描述生成 PPT
说明
该步骤不支持选择模板，若需生成模板预览，续调用请求生成 PPT 封面图片接口
1.请求生成 PPT 文档
（1）说明
- **请求地址：**https://saas.api.yoo-ai.com/apps/ppt-create
- **请求方法：**POST
（2）请求参数
Headers（通过在韦尼克平台创建应用获取）
| 参数名 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body 参数
text、custom_data 二选一必填
custom_data 在一句话描述生成中非必填
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
| text | string | Y | 请求生成 PPT 文本 | |
| custom_data | object | Y | 自定义结构，包含标题、副标题、作者、大纲、内容等信息 | |
| custom_data.title | string | Y | 标题 | |
| custom_data.sub_title | string | N | 副标题 | |
| custom_data.author | string | N | 作者 | 尤小优 |
| custom_data.catalogs | array | Y | 大纲 | |
| custom_data.contents | array | Y | 内容 | |
| complex | int | N | PPT 复杂度（1-简单 2-中等 3-复杂） | 1 |
| font_name | string | N | 字体 | |
| language | string | N | en-US （英文），zh-TW（繁体） | |
| color | string | N | 颜色 | |
| user_name | string | N | 作者名 | 尤小优 |
| cover_id | string | N | 封面 ID（通过模版接口获取） | |
| ai_picture | bool | N | 是否使用 ai 生成图片 | False |
（3）请求示例
仅展示使用一句话描述生成 PPT 文档示例
json
{
"text": "帮我生成一份网络安全ppt",
"complex": 3,
"font_name": "黑体",
"language": "en-US",
"color": "蓝色",
"user_name": "张三"
}（4）响应内容
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | integer | 状态码 |
| msg | string | 响应消息 |
| data | object | 数据体 |
| data.id | string | 任务 ID |
（5）响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "fYD32vr5wS8QzN7kjzRasQuanFhwqtMj"
}
}2.获取 PPT 生成结果
（1）说明
- **请求地址：**https://saas.api.yoo-ai.com/apps/ppt-result
- **请求方法：**GET
（2）请求参数
Headers
| 参数名 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query 参数
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
| id | string | Y | 任务 ID |
（3）请求示例
json
{
"id": "fYD32vr5wS8QzN7kjzRasQuanFhwqtMj"
}（4）响应内容
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | integer | 状态码 |
| msg | string | 响应消息 |
| data | object | 数据体 |
| data.id | string | 任务 ID |
| data.images_url | array | PPT 中所有的图片 URL 和时间戳的数组 |
| data.images_url.url | string | PPT 图片的 url |
| data.images_url.time | string | 时间戳 |
| 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 |
（5）响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "UEyGDFqrgEzr6EfS2VpbEUrjw2ADeqgm",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/72l3rvun0ccvl.png",
"time": 1741761966
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/u2mkt2in3r3dj.png",
"time": 1741761966
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/2b7i9nlliq52a.png",
"time": 1741761967
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/nacgf0tho54jq.png",
"time": 1741761983
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/fm1ocu2qazht2.png",
"time": 1741761984
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/rrftpiemeg73z.png",
"time": 1741761968
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/576ex3yuu4h2s.png",
"time": 1741761985
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/nyr1h7tt7l6es.png",
"time": 1741761985
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/52qjc0wx7cbhl.png",
"time": 1741761969
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/0etpzyktcjuo4.png",
"time": 1741761987
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/7dc43630031y1.png",
"time": 1741761988
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/2w4o9tlb6pq6l.png",
"time": 1741761970
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/x3f3dyl1z0kvc.png",
"time": 1741761989
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/bbyt5tfdnh7w7.png",
"time": 1741761990
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250312/ajvvlm09vh0z9.png",
"time": 1741761991
}
],
"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",
"ppt_title": "网络安全基础与重要性",
"page_count": 15,
"progress": 100,
"status": 2,
"first_image_up_at": "2025-03-12 14:46:06",
"created_at": "2025-03-12 14:45:44",
"updated_at": "2025-03-12 14:46:33",
"state_description": "生成已完成...",
"process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=UEyGDFqrgEzr6EfS2VpbEUrjw2ADeqgm",
"preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=UEyGDFqrgEzr6EfS2VpbEUrjw2ADeqgm"
}
}3.生成 PPT 下载地址
（1）说明
- **请求地址：**https://saas.api.yoo-ai.com/apps/ppt-download
- **请求方法：**GET
（2）请求参数
Headers
| 参数名 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query 参数
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
| id | string | Y | 任务 ID |
（3）请求示例
json
{
"id": "fYD32vr5wS8QzN7kjzRasQuanFhwqtMj"
}（4）响应内容
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | integer | 状态码 |
| msg | string | 描述消息 |
| data | object | 数据体 |
| data.download_url | string | 下载链接 |
（5）响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250312/g9cc8i285ys4w.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-03-12T07%3A00%3A15Z%2F3600%2F%2F4879932ff2ed838005188027061ae82df939c5b28f0598e9796305f0d8322085"
}
}