韦尼克产品文档

Appearance

02-逐步生成PPT ​

这是最推荐的“完整流程”生成方式：从PPT描述/主题/标题出发，逐步生成完整的PPT。

  • 支持用户二次编辑确认PPT大纲
  • 提供各种风格的模板，支持用户可视化自由选择风格方案

适合对内容结构有要求，希望可以查看编辑大纲、查看选择模板，并生成可以直接使用的高质量PPT的场景。

🧭调用流程 ​

1.📝AI标题大纲生成（/apps/ppt-structure） ​

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Body参数（application/json） ​

  • title、text、theme不能同时为空，三选一
  • 多个参数情况下，参数优先级title>theme>text
参数名类型必填描述默认值
titlestringYPPT标题
textstringYPPT描述
themestringYPPT主题
complexintNPPT复杂度（1-简单 2-中等 3-复杂）1

请求示例 ​

json
{
    "title":"网络安全大赛",
    "theme":"网络安全主题",
    "text":"生成一份网络安全PPT"
}

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
titlestringPPT标题
catalogsArray大纲数组

catalogs

参数名类型描述
catalogstring一级标题
sub_catalogArray二级标题

响应示例 ​

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "title": "网络安全大赛",
        "catalogs": [
            {
                "catalog": "网络安全威胁分析",
                "sub_catalog": [
                    "新型网络攻击手段剖析",
                    "网络钓鱼与社交工程防范",
                    "勒索软件与数据保护策略"
                ]
            },
            {
                "catalog": "安全防护体系建设",
                "sub_catalog": [
                    "防火墙与入侵检测系统部署",
                    "加密技术与数据备份策略",
                    "安全漏洞扫描与应急响应"
                ]
            },
            {
                "catalog": "网络安全人才培养",
                "sub_catalog": [
                    "网络安全专业教育体系构建",
                    "实战化网络安全人才培养",
                    "网络安全意识普及与提升"
                ]
            },
            {
                "catalog": "法律法规与合规要求",
                "sub_catalog": [
                    "网络安全法律法规解读",
                    "企业网络安全合规实践",
                    "个人信息保护与数据跨境流动"
                ]
            },
            {
                "catalog": "网络安全赛事解析",
                "sub_catalog": [
                    "网络安全大赛赛题类型分析",
                    "攻防演练与实战技巧分享",
                    "网络安全赛事对行业的推动作用"
                ]
            },
            {
                "catalog": "未来网络安全趋势",
                "sub_catalog": [
                    "物联网与5G时代的网络安全",
                    "人工智能在网络安全中的应用",
                    "网络安全国际合作与共同发展"
                ]
            }
        ]
    }
}

2.🎨AI模板生成方案（/apps/ppt-cover） ​

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Body参数（application/json） ​

参数名类型必填描述默认值
titlestringYPPT标题
countintN返回模板个数，数量范围(0,4]1
user_namestringN作者尤小优
colorstringN模板主题色，取值为["紫色","红色","橙色","黄色","绿色","青色","蓝色","粉色"]
stylestringN模板风格，取值为["科技风","商务风","小清新","极简风","中国风","可爱卡通"]
sizestringN预览封面图片大小（1=480 * 270；2=960 * 540；3=1920 * 1080）3

请求示例 ​

json
{
    "title":"网络安全",
    "count":1,
    "user_name":"张三",
    "color":"蓝色",
    "style":"商务风",
    "size":"3"
}

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.cover_imagestring封面预览图
data.cover_idstring封面ID
data.colorstring封面主题色
data.color_listArray配色列表

响应示例 ​

json
{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "cover_image": "http://file.static.yoojober.cn/temp/ppt/images/20250530/83c06607c4fc45cf9cc112729ca87905.png",
            "cover_id": "6JCxtc-0",
            "color": "蓝色",
            "color_list": [
                "#001630",
                "#FFFFFF",
                "#FFFFFF",
                "#1F2631",
                "#2385FD",
                "#00D4FF",
                "#3f8efc",
                "#B5CCFF",
                "#bfd7ff",
                "#e2fdff",
                "#2385FD",
                "#00D4FF"
            ]
        }
    ]
}

3.📥PPT文档生成（/apps/ppt-create） ​

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Body参数（application/json） ​

参数名类型必填描述默认值
cover_idstringN模板ID，从“步骤二”中获取
font_namestringN字体（黑体、宋体、仿宋、幼圆、楷书、隶书）黑体
languagestringNen-US（英文），zh-TW（繁体中文）简体中文
ai_pictureboolN是否使用AI生成图片false
reportboolNtrue - 编辑器异步渲染，获取任务ID后可以直接调用【步骤4-PPT编辑器】，会直接进入生成渲染页面。【⚠️注意】使用异步渲染后，获取结果接口将不会再返回图片数据。false
ai_watermarkboolN是否在PPT封面页展示“AI生成”标识。true=显示，false=不显示。false
custom_dataobjectY大纲参数，从步骤一中获取，具体看custom_data表格

custom_data

参数类型必须说明
titlestringY标题
catalogsarrayN大纲，具体看catalogs表格

catalogs（Array）

参数类型必须说明
catalogstringY一级大纲
sub_catalogarray (string)N该一级大纲下的二级大纲 可以为空，但要尽量保证所有一级大纲下都有或者都没有二级大纲

请求示例 ​

json
{
    "cover_id": "6JCxtc-0",
    
    "custom_data":{
        "title": "网络安全大赛",
        "catalogs": [
            {
                "catalog": "网络安全威胁分析",
                "sub_catalog": [
                    "新型网络攻击手段剖析",
                    "网络钓鱼与社交工程防范",
                    "勒索软件与数据保护策略"
                ]
            },
            {
                "catalog": "安全防护体系建设",
                "sub_catalog": [
                    "防火墙与入侵检测系统部署",
                    "加密技术与数据备份策略",
                    "安全漏洞扫描与应急响应"
                ]
            },
            {
                "catalog": "网络安全人才培养",
                "sub_catalog": [
                    "网络安全专业教育体系构建",
                    "实战化网络安全人才培养",
                    "网络安全意识普及与提升"
                ]
            },
            {
                "catalog": "法律法规与合规要求",
                "sub_catalog": [
                    "网络安全法律法规解读",
                    "企业网络安全合规实践",
                    "个人信息保护与数据跨境流动"
                ]
            },
            {
                "catalog": "网络安全赛事解析",
                "sub_catalog": [
                    "网络安全大赛赛题类型分析",
                    "攻防演练与实战技巧分享",
                    "网络安全赛事对行业的推动作用"
                ]
            },
            {
                "catalog": "未来网络安全趋势",
                "sub_catalog": [
                    "物联网与5G时代的网络安全",
                    "人工智能在网络安全中的应用",
                    "网络安全国际合作与共同发展"
                ]
            }
        ]
    }
}

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.idstring任务ID

响应示例 ​

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "B3Auv7bBFhuRQR2bMDCFbZwPjJ9c3252"
    }
}

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

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Query参数 ​

参数名类型必填描述默认值
idstringY任务ID

请求示例 ​

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

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.idstring任务id
data.images_urlarrayPPT中所有的图片URL和时间戳的数组
data.note_statusintPPT备注状态（0-无备注，1-有备注）
data.introducestringPPT的大纲
data.ppt_titlestringPPT标题
data.page_countintPPT的页数
data.progressint生成进度，100表示已完成
data.statusint状态（1-进行中|2-已完成|3-生成失败）
data.first_image_up_atstring第一张图片上传的时间
data.created_atstringPPT创建的时间
data.updated_atstringPPT最后更新的时间
data.state_descriptionstring状态描述（生成已完成|正在生成演示内容）
data.process_urlstring生成进度的URL
data.preview_urlstringPPT预览的URL，仅用于**【内部测试预览】**

响应示例 ​

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "pRtdwgwZca9kzVMTTBT9gym6Uf8ZsrHs",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/buezbtmis7gql.png",
                "time": 1763004106,
                "page": 0
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/w36gwodmr1rmo.png",
                "time": 1763004106,
                "page": 1
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/60c01w63aq9bv.png",
                "time": 1763004107,
                "page": 2
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/wyq6fz9vovo77.png",
                "time": 1763004113,
                "page": 3
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/n8pqpv1qp1x78.png",
                "time": 1763004114,
                "page": 4
            }
        ],
        "note_status": 0,
        "introduce": "父亲节营销活动规划案\r\n社会责任与品牌形象\r\n公益慈善活动\r\n",
        "ppt_title": "父亲节营销活动规划案",
        "page_count": 5,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2025-11-13 11:21:46",
        "created_at": "2025-11-13 11:21:38",
        "updated_at": "2025-11-13 11:21:55",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=pRtdwgwZca9kzVMTTBT9gym6Uf8ZsrHs",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=pRtdwgwZca9kzVMTTBT9gym6Uf8ZsrHs"
    },
    "request_id": "YOO-saas-api69154ed7a6a69"
}

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

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Query参数 ​

参数名类型必填描述默认值
idstringY任务ID

请求示例 ​

json
{
    "id":"cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
}

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.download_urlstring下载链接

响应示例 ​

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-30T04%3A18%3A29Z%2F3600%2F%2F656d147a4b8e7ab93a6b617e094d55b861382cbc30743f650fa9546eb8c46b18"
    }
}

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

接口说明 ​

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

请求参数 ​

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx

  • Body参数（application/json） ​

参数名类型必填描述默认值
idstringY任务ID
expirestringYURL有效时间-秒86400
reportboolNtrue - 获取异步渲染编辑器链接false

请求示例 ​

json
{
    "id":"dNXxxaKDpSXFcGsufRyJ6w6nBxzmsyz6",
    "expire":86400
}

响应参数 ​

参数名类型描述
codeinteger状态码
msgstring响应消息
dataobject数据体
data.urlstring编辑器URL链接
data.expire_timestring链接到期时间

响应示例 ​

  • 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":{}
}