全流程生成 PPT

说明

1.AI 标题大纲生成

（1）说明

请求地址**：**https://saas.api.yoo-ai.com/apps/ppt-structure
请求方法**：**POST

（2）请求参数

Headers（通过在韦尼克平台创建应用获取）

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

Body 参数
title、text、theme 不能同时为空
参数优先级 title>theme>text

参数名	类型	必填	描述	默认值
title	string	Y	PPT 标题	网络安全大赛
text	string	Y	PPT 描述	生成一份网络安全 PPT
theme	string	Y	PPT 主题	网络安全主题

（3）请求示例

json

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

（4）响应内容

名称	类型	说明
code	int	状态码
msg	string	响应消息
data	object	数据体
data.title	string	PPT 标题
data.catalogs	array	大纲数组
data.catalogs.catalog	string	一级大纲标题
data.catalogs.sub_catalog	array	二级大纲数组

（5）响应示例

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "title": "网络安全",
    "catalogs": [
      {
        "catalog": "网络安全威胁分析",
        "sub_catalog": [
          "常见网络攻击手段剖析",
          "恶意软件与病毒传播机制",
          "高级持续性威胁（APT）防范"
        ]
      },
      {
        "catalog": "数据安全与保护",
        "sub_catalog": [
          "数据加密与解密技术",
          "数据备份与恢复策略",
          "隐私保护法规与合规实践"
        ]
      },
      {
        "catalog": "网络安全防御体系",
        "sub_catalog": [
          "防火墙与入侵检测系统构建",
          "网络安全态势感知平台建设",
          "应急响应与灾难恢复演练"
        ]
      },
      {
        "catalog": "网络安全意识培养",
        "sub_catalog": [
          "员工网络安全教育培训",
          "网络安全文化建设推广",
          "网络安全意识提升策略"
        ]
      }
    ]
  }
}

2.请求生成 PPT 封面图片

（1）说明

**请求地址：**https://saas.api.yoo-ai.com/apps/ppt-cover
**请求方法：**POST

（2）请求参数

Headers（通过在韦尼克平台创建应用获取）

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

Body 参数

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

（3）请求示例

json

{
  "title": "网络安全",
  "count": "3",
  "user_name": "张三",
  "color": "黄色",
  "style": "科技风",
  "size": "2"
}

（4）响应内容

名称	类型	说明
code	int	状态码
msg	string	响应消息
data	Array	数据体
data.cover_image	string	封面预览图
data.cover_id	string	封面 ID
data.color	string	封面主题色
data.color_list	Array	配色列表

（5）响应示例

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "cover_image": "http://file.static.yoojober.cn/temp/ppt/images/20250313/bfc85100d45042a8bed9e3d41983f5ae.png",
      "cover_id": "MNS5aE-0",
      "color": "黄色",
      "color_list": [
        "#FFFDF6",
        "#472603",
        "#FFFFFF",
        "#FFFBF7",
        "#FCC30C",
        "#FFA50F",
        "#FF8621",
        "#FF6533",
        "#F94143",
        "#EA1152",
        "#FCC30C",
        "#FFA50F"
      ]
    },
    {
      "cover_image": "http://file.static.yoojober.cn/temp/ppt/images/20250313/0ebe3a1de1e34a7baf1ac0451275c5f8.png",
      "cover_id": "MNS5aE-1",
      "color": "黄色",
      "color_list": [
        "#000000",
        "#FFFFFF",
        "#FFFFFF",
        "#2B1B03",
        "#FFAD34",
        "#ffe000",
        "#E4B72F",
        "#C3986D",
        "#C17529",
        "#ffbb1a",
        "#FFAD34",
        "#ffe000"
      ]
    },
    {
      "cover_image": "http://file.static.yoojober.cn/temp/ppt/images/20250313/7206c103c82b4ea28cf45a7f90315bd0.png",
      "cover_id": "MNS5aE-2",
      "color": "黄色",
      "color_list": [
        "#FFFDF6",
        "#472603",
        "#FFFFFF",
        "#FFFBF7",
        "#FCC30C",
        "#FFA50F",
        "#FF8621",
        "#FF6533",
        "#F94143",
        "#EA1152",
        "#FCC30C",
        "#FFA50F"
      ]
    }
  ]
}

3.请求生成 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 二选一必填

参数名	类型	必填	描述	默认值
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 生成图片

（3）请求示例

仅展示使用一句话描述生成 PPT 文档示例

json

{
  "text": "帮我生成一份网络安全ppt",
  "complex": 3,
  "font_name": "黑体",
  "language": "en-US",
  "color": "蓝色",
  "user_name": "张三",
  "cover_id": "MNS5aE-0"
}

（4）响应内容

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

（5）响应示例

json

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

4.获取 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"
  }
}

5.生成 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"
  }
}

全流程生成 PPT ​

说明 ​

1.AI 标题大纲生成 ​

（1）说明 ​

（2）请求参数 ​

（3）请求示例 ​

（4）响应内容 ​

（5）响应示例 ​

2.请求生成 PPT 封面图片 ​

（1）说明 ​

（2）请求参数 ​

（3）请求示例 ​

（4）响应内容 ​

（5）响应示例 ​

3.请求生成 PPT 文档 ​

（1）说明 ​

（2）请求参数 ​

（3）请求示例 ​

（4）响应内容 ​

（5）响应示例 ​

4.获取 PPT 生成结果 ​

（1）说明 ​

（2）请求参数 ​

（3）请求示例 ​

（4）响应内容 ​

（5）响应示例 ​

5.生成 PPT 下载地址 ​

（1）说明 ​

（2）请求参数 ​

（3）请求示例 ​

（4）响应内容 ​

（5）响应示例 ​

全流程生成 PPT

说明

1.AI 标题大纲生成

（1）说明

（2）请求参数

（3）请求示例

（4）响应内容

（5）响应示例

2.请求生成 PPT 封面图片

（1）说明

（2）请求参数

（3）请求示例

（4）响应内容

（5）响应示例

3.请求生成 PPT 文档

（1）说明

（2）请求参数

（3）请求示例

（4）响应内容

（5）响应示例

4.获取 PPT 生成结果

（1）说明

（2）请求参数

（3）请求示例

（4）响应内容

（5）响应示例

5.生成 PPT 下载地址

（1）说明

（2）请求参数

（3）请求示例

（4）响应内容

（5）响应示例