09-企业模板生成PPT

企业模板录入流程

• 企业可通过 商务对接 提供模板文件（.pptx格式），由平台完成模板解析与录入。
• 我们将协助完成 模板审核、样式配置与上线，确保生成效果符合企业使用标准。
• 模板录入成功后，企业用户即可在生成PPT时指定使用对应模板。

📥1.企业模板生成（/apps/ppt-company-create）

接口说明

• 接口地址：https://saas.api.yoo-ai.com/apps/ppt-company-create
• 请求方式： POST

请求参数

• Header

在韦尼克平台创建应用获取，刷新Token接口

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

• Body参数（application/json）

参数名	类型	必填	描述	默认值
text	string	Y	请求生成PPT文本
company	string	Y	企业名称
language	string	N	中文zh-CN（默认）；英文en-US；繁体zh-TW	zh-CN
template_url	string	N	企业对应的模板文件URL地址，仅支持PPTX文件
ai_picture	boolean	N	是否使用AI图片
color	string	N	PPT模板主题色（紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色）
user_name	string	N	作者名称
ppt_complex	int	N	PPT复杂度（1-简单 2-中等 3-复杂）
font_name	string	N	字体（黑体、宋体、仿宋、幼圆、楷书、隶书）

请求示例

{
    "text":"AIPC市场分析",
    "company":"intel"
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.id	string	任务 ID

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A"
    }
}

2.🛠️PPT编辑器（/apps/ppt-editor）

接口说明

• 接口地址：https://saas.api.yoo-ai.com/apps/ppt-editor
• 请求方式： POST

请求参数

• Header

在韦尼克平台创建应用获取，刷新Token接口

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

• Body参数（application/json）

参数名	类型	必填	描述	默认值
id	string	Y	任务ID
expire	string	Y	URL有效时间-秒	86400
report	bool	N	true - 获取异步渲染编辑器链接	false

请求示例

{
    "id":"nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A",
    "expire":86400,
    "report":true
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.url	string	编辑器URL链接
data.expire_time	string	链接到期时间

响应示例

• PPT文件已经渲染完成：

{
    "code": 200,
    "msg": "success",
    "data": {
        "url": "https://aigc.yoo-ai.com/editor?id=api%3Anf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A&token=PJAKMNDHWG7UGHTJAD4SBZ5HE5EYFAKF&report=0",
        "expire_time": "2025-09-16 17:24:37"
    },
    "request_id": "YOO-saas-api68c7db553a443"
}

• PPT正在生成中：

{
    "code":204,
    "msg":"请等待PPT生成完成...",
    "data":{}
}

3.🔄 获取生成PPT结果（/apps/ppt-result）

需要通过这个接口获取生成状态，通过生成状态去判断是否能获取PPT下载链接

接口说明

• 接口地址：https://saas.api.yoo-ai.com/apps/ppt-result
• 请求方式： GET

请求参数

• Header

在韦尼克平台创建应用获取，刷新Token接口

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

• Query参数

参数名	类型	必填	描述	默认值
id	string	Y	任务ID

请求示例

https://saas.api.yoo-ai.com/apps/ppt-result?id=YsHkZZxxxxxxXR3rXwS

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.id	string	任务id
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.created_at	string	PPT创建的时间
data.updated_at	string	PPT最后更新的时间
data.state_description	string	状态描述（生成已完成|正在生成演示内容）
data.process_url	string	生成进度的URL
data.preview_url	string	PPT预览的URL，仅用于【内部测试预览】

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "images_url": [
            
        ],
        "note_status": 0,
        "introduce": "AIPC市场，增长点何在？AIPC技术创新驱动AIPC技术创新驱动AIPC技术创新驱动AIPC技术创新驱动AIPC技术创新驱动",
        "ppt_title": "AIPC市场，增长点何在？",
        "page_count": 13,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2025-09-15 17:12:52",
        "created_at": "2025-09-15 17:12:39",
        "updated_at": "2025-09-15 17:14:50",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A",
        "id": "nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A"
    },
    "request_id": "YOO-saas-api68c7daa89605b"
}

4.⬇️PPT下载（/apps/ppt-download）

通过步骤三得到"status": 2时即可获取下载链接

接口说明

• 接口地址：https://saas.api.yoo-ai.com/apps/ppt-download
• 请求方式： GET

请求参数

• Header

在韦尼克平台创建应用获取，刷新Token接口

参数名	类型	描述	示例值
Authorization	string	Authorization - Bearer Token	Bearer Yoo-xxxxxxxxx

• Query参数

参数名	类型	必填	描述	默认值
id	string	Y	任务ID

请求示例

{
    "id":"nf5DWsKGG24kgVWX3dq6CNtsZ29s9f5A"
}

响应参数

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	object	数据体
data.download_url	string	下载链接

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250915/pmxqr6hwx4lez.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-09-15T09%3A26%3A09Z%2F3600%2F%2Fda073b7d77dd1f5a69cf31de164070c5cc74ebc69c0183116fc27946d7d741f4"
    },
    "request_id": "YOO-saas-api68c7dbb14cc4c"
}