Appearance
01-描述(主题)一键生成PPT
这是推荐的**“一键生成”方式**:输入一句话/主题,立刻生成完整PPT。
- 不需要选择模板
- 不需要设计大纲
- 不支持自定义结构
适合需要快速出稿或内容测试的场景。
🧭调用流程
1.📥PPT文档生成(/apps/ppt-create
)
接口说明
- 接口地址:
https://saas.api.yoo-ai.com/apps/ppt-create
- 请求方式: POST
请求参数
Header
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
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 |
请求示例
json
{
"text":"生成一个人工智能PPT",
"complex":1,
"font_name":"幼圆",
"language":"zh-TW",
"color":"蓝色",
"user_name":"张三",
"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-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":"cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
}
响应参数
参数名 | 类型 | 描述 |
---|---|---|
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": "cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e",
"images_url": [
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/yyw5p1cytogfs.png",
"time": 1748508229
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/5c46x4daeeelk.png",
"time": 1748508234
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/wgmhxmb1d1wgl.png",
"time": 1748508236
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/7tmilqb85x3oy.png",
"time": 1748508260
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/s3ciyrhvqnifl.png",
"time": 1748508264
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/pi1gvtooly9t3.png",
"time": 1748508271
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/0z8m76ip64rq3.png",
"time": 1748508237
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/wq61cteystz15.png",
"time": 1748508277
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/te7ard7w4x0o7.png",
"time": 1748508282
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/u2zkmsq3sxkv2.png",
"time": 1748508287
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/9c12crfinc6yf.png",
"time": 1748508238
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/w8zhtagffv2b8.png",
"time": 1748508291
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/lhn91baxzk37z.png",
"time": 1748508298
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/7406tfxfrikxz.png",
"time": 1748508303
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/3testck7leq5l.png",
"time": 1748508239
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/uzr7cdf5vnbxz.png",
"time": 1748508306
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/zv639vqo4zt14.png",
"time": 1748508312
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/uusuig1g8oqtb.png",
"time": 1748508318
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/veyc06by3mv4v.png",
"time": 1748508240
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/k6xkaoh9s33mz.png",
"time": 1748508324
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/7sli2p70hswdb.png",
"time": 1748508330
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/heyc2sowp8e2w.png",
"time": 1748508334
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/o033gtp54fr60.png",
"time": 1748508241
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/wcl9cy5b7cfl2.png",
"time": 1748508339
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/t06wbps9ypce5.png",
"time": 1748508345
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/q26hvodfkkfhc.png",
"time": 1748508354
},
{
"url": "https://file.static.yoojober.cn/chatppt/20250529/hhbc28igo062l.png",
"time": 1748508356
}
],
"note_status": 0,
"introduce": "機器學習科技的突破方向\r\n算灋模型創新\r\n深度學習模型優化\r\n强化學習在複雜任務應用\r\n聯邦學習保障資料安全\r\n算灋模型創新\r\n大規模數據高效預處理\r\n數據標注自動化提升\r\n數據增强科技增强模型泛化\r\n算灋模型創新\r\nGPU在機器學習中的應用\r\nTPU等專用晶片的優勢\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": 27,
"progress": 100,
"status": 2,
"first_image_up_at": "2025-05-29 16:43:49",
"created_at": "2025-05-29 16:42:56",
"updated_at": "2025-05-29 16:45:58",
"state_description": "生成已完成...",
"process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e",
"preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
}
}
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":"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"
}
}
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":{}
}