Appearance
05-基于答辩论文生成PPT
该接口支持上传学术论文(PDF / Word),由系统自动解析论文结构,生成用于答辩场景的专业型演示PPT。包含绪论、研究背景、核心方法、成果展示等标准答辩模块。
📌 使用前提
- 需上传一篇内容清晰、结构完整的论文文档
- 支持
.doc
,.docx
,
🧭调用流程
1.📄通过论文生成PPT(/apps/ppt-create-thesis
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-create-thesis
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body参数(
application/json
)
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
file_key | string | Y | 文件url | |
style | string | N | 风格:[科技/商务/小清新/可爱卡通/中国风/极简/党政] | |
color | string | N | 颜色:[紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色] | |
title | string | N | 标题 优先自定义,为空使用解析结果标题 | |
pleader | string | N | 汇报人 为空默认尤小优 | |
advisor | string | N | 指导老师 为空默认尤小优 | |
school | string | N | 学校 | |
school_logo | string | N | 学校logo | |
school_pciture | string | N | 学校图片 |
请求示例
json
{
"file_key":"https://saas.file.yoo-ai.com/20250530/f2025053-0162-1168-17fb-abccfec70906.docx",
"style":"科技",
"color":"蓝色",
"title":"PPT标题",
"pleader":"汇报人",
"advisor":"指导老师",
"school":"学校",
"school_logo":"http://xxx.com/png.png",
"school_pciture":"http://xxx.com/png.png"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
code | integer | 状态码 |
msg | string | 响应消息 |
data | object | 数据体 |
id | string | 任务ID |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"id": "T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv"
}
}
2. 🔄 获取生成PPT结果(/apps/ppt-result
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-result
- 请求方式: GET
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query参数
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID |
请求示例
json
{
"id":"T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
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": "T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/v15xlpt89z9wa.png",
"time": 1748593744
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/oqdmf2hpxucqw.png",
"time": 1748593745
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/zox0kyx7wseju.png",
"time": 1748593746
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/vvoh15713fxij.png",
"time": 1748593753
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/22zbo06y4nigr.png",
"time": 1748593753
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/b3mbdcaeqdl6k.png",
"time": 1748593758
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/7899yf221vrec.png",
"time": 1748593746
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/4h12i5pcd086r.png",
"time": 1748593758
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/luk5ksdnt8jme.png",
"time": 1748593759
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/ghw0vnhd4iwx2.png",
"time": 1748593759
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/1lslmjayq2k2k.png",
"time": 1748593747
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/ckp3oyouolqup.png",
"time": 1748593759
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/9vp9er3drwbem.png",
"time": 1748593760
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/st8qec1apslqx.png",
"time": 1748593760
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/5tzteu4zw13yr.png",
"time": 1748593748
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/7yiwy1ujb5a98.png",
"time": 1748593761
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/vcj09r5efwmyl.png",
"time": 1748593761
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/ps9k85nssmrx2.png",
"time": 1748593761
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/3u08wqc4fsrxx.png",
"time": 1748593749
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/he1lb9pmq1ypp.png",
"time": 1748593762
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/8cus4t5o0bi9y.png",
"time": 1748593762
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/uut9fwsxz86n2.png",
"time": 1748593762
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250530/d5vkd0xw6045p.png",
"time": 1748593762
}
],
"note_status": 0,
"introduce": "ChatPPT:AI生成PPT的智能工具\r\n产品简介与定位\r\nChatPPT概述\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": "ChatPPT:AI生成PPT的智能工具",
"page_count": 23,
"progress": 100,
"status": 2,
"first_image_up_at": "2025-05-30 16:29:04",
"created_at": "2025-05-30 16:28:26",
"updated_at": "2025-05-30 16:29:24",
"state_description": "生成已完成...",
"process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv",
"preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv"
}
}
3.⬇️PPT下载(/apps/ppt-download
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-download
- 请求方式: GET
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Query参数
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID |
请求示例
json
{
"id":"T6akSZ7NRbGgpXfv5ZG4kGgQnHXFsvCv
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
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/20250530/4s8hhx3hser6l.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-05-30T08%3A30%3A23Z%2F3600%2F%2Fd0885cc44b364e46c552531fb9344841b0754350cd8802855efa9a3f27f3ab39"
}
}
4.🛠️PPT编辑器(/apps/ppt-editor
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-editor
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
Authorization | string | Authorization - Bearer Token | Bearer Yoo-xxxxxxxxx |
Body参数(
application/json
)
参数名 | 类型 | 必填 | 描述 | 默认值 |
---|---|---|---|---|
id | string | Y | 任务ID | |
expire | string | Y | URL有效时间-秒 | 86400 |
请求示例
json
{
"id":"dNXxxaKDpSXFcGsufRyJ6w6nBxzmsyz6",
"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":{}
}