02-绘图PPT (Banana版)

这是推荐的**“风格化生成”方式**：选择特定风格/模板，输入一句话/主题，生成精美PPT。
需要选择风格/模板
不需要设计大纲
不支持自定义结构
适合对视觉效果有特定要求的场景。

⚠️重要说明（可编辑性）

该接口生成的 PPT 不支持编辑。
下载得到的 .pptx 文件为图片型PPT：页面内容以图片形式呈现，非可编辑的文本/图形元素。

🧭调用流程

调用 /apps/ppt-banana-style 获取风格/模板列表及其ID。
调用 /apps/ppt-banana 传入主题和风格ID生成PPT任务。
调用 /apps/ppt-result 轮询获取生成结果。
调用 /apps/ppt-download 获取下载链接。

1. 🎨 获取样式/模板列表（`/apps/ppt-banana-style`）

接口说明

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

请求参数

Header

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

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

Body参数（multipart/form-data）

参数名	类型	必填	描述	默认值
type	string	Y	类型（style - 风格，template - 模板）

请求示例

bash

{
    "type":"style"
}

响应参数

type="style" 响应

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	array	数据列表
data.style_id	string	风格ID
data.name	string	风格名称
data.template_type	string	模板类型
data.doc_type	string	文档类型
data.bg_color	string	背景色
data.images	object	预览图集合
data.images.cover_image	string	封面预览图
data.images.chapter_image	string	章节预览图
data.images.content1_image	string	内容预览图1
data.images.content2_image	string	内容预览图2
data.images.catalogue_image	string	目录预览图

type="template" 响应

参数名	类型	描述
code	integer	状态码
msg	string	响应消息
data	array	数据列表
data.style_id	string	模板ID
data.style_name	string	模板名称
data.created_at	string	创建时间
data.bg_color	string	背景色
data.images	object	预览图集合
data.images.cover_url	string	封面预览图

响应示例

type="style"

json

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "style_id": "XPd6kB",
            "name": "3D黏土",
            "template_type": "standard",
            "doc_type": "standard",
            "bg_color": "#BAE0F5",
            "images": {
                "cover_image": "https://image.yoojober.com/users/2025-12/694ca476a98fc.jpg",
                "chapter_image": "https://image.yoojober.com/users/2025-12/694ca47f40fff.jpg",
                "content1_image": "https://image.yoojober.com/users/2025-12/694ca483b8741.jpg",
                "content2_image": "https://image.yoojober.com/users/2025-12/694ca4888641a.jpg",
                "catalogue_image": "https://image.yoojober.com/users/2025-12/694ca47ab5448.jpg"
            }
        },
        {
            "style_id": "GTG4ZT",
            "name": "水墨风",
            "template_type": "standard",
            "doc_type": "standard",
            "bg_color": "#90B5B9",
            "images": {
                "cover_image": "https://image.yoojober.com//users/2025-12/694ceb081bdfb.jpg",
                "chapter_image": "https://image.yoojober.com//users/2025-12/694ceb12aca0e.jpg",
                "content1_image": "https://image.yoojober.com//users/2025-12/694ceacbe49a3.jpg",
                "content2_image": "https://image.yoojober.com//users/2025-12/694cead000682.jpg",
                "catalogue_image": "https://image.yoojober.com//users/2025-12/694ceb0d159e4.jpg"
            }
        }
    ]
}

type="template"

json

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "style_id": "dzgSKy",
            "style_name": "现代波普风",
            "created_at": "2025-12-24 17:10:30",
            "images": {
                "cover_url": "https://image.yoojober.com/upload-m/2025-12/694b8d00a930e.png"
            },
            "bg_color": "#7299DC"
        },
        {
            "style_id": "pBUWQj",
            "style_name": "小狗绘本风",
            "created_at": "2025-12-24 17:10:30",
            "images": {
                "cover_url": "https://image.yoojober.com/upload-m/2025-12/694b8e2e93b69.png"
            },
            "bg_color": "#7299DC"
        }
    ]
}

2. 📥 PPT文档生成（`/apps/ppt-banana`）

接口说明

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

请求参数

Header

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

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

Body参数（application/json）

参数名	类型	必填	描述	默认值
text	string	Y	请求生成PPT文本（主题）
complex	int	N	PPT复杂度（1-简单 2-中等 3-复杂）	1
style	string	N	风格ID/模板ID (通过接口1获取)。如果不选择style，可以使用import_image上传参考图。
import_image	string	N	参考图片URL，仅支持静态文件链接（当不选择style时使用）。
doc_type	string	N	文档类型

请求示例

json

{
    "text":"生成一份地震报告",
    "complex":2,
    "style":"",
    "import_image":"",
    "doc_type":""
}

响应参数

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

响应示例

json

{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "vvHaGbZf4yHaqm8ZMVJ7r7hgW6f4UMcz"
    },
    "request_id": "YOO-saas-api69afb988dc08d"
}

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

接口说明

接口地址：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

请求示例

ruby

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

响应参数

参数名	类型	描述
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": "vvHaGbZf4yHaqm8ZMVJ7r7hgW6f4UMcz",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20251113/buezbtmis7gql.png",
                "time": 1763004106,
                "page": 0
            }
        ],
        "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=vvHaGbZf4yHaqm8ZMVJ7r7hgW6f4UMcz",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=vvHaGbZf4yHaqm8ZMVJ7r7hgW6f4UMcz"
    },
    "request_id": "YOO-saas-api69154ed7a6a69"
}

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

接口说明

接口地址：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

请求示例

json

{
    "id":"vvHaGbZf4yHaqm8ZMVJ7r7hgW6f4UMcz"
}

响应参数

参数名	类型	描述
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"
    }
}

02-绘图PPT (Banana版)

⚠️重要说明（可编辑性）

🧭调用流程

1. 🎨 获取样式/模板列表（`/apps/ppt-banana-style`）

接口说明

请求参数

Header

Body参数（`multipart/form-data`）

请求示例

响应参数

type="style" 响应

type="template" 响应

响应示例

type="style"

type="template"

2. 📥 PPT文档生成（`/apps/ppt-banana`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

02-绘图PPT (Banana版) ​

⚠️重要说明（可编辑性） ​

🧭调用流程 ​

1. 🎨 获取样式/模板列表（/apps/ppt-banana-style） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（multipart/form-data） ​

请求示例 ​

响应参数 ​

type="style" 响应 ​

type="template" 响应 ​

响应示例 ​

type="style" ​

type="template" ​

2. 📥 PPT文档生成（/apps/ppt-banana） ​

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

02-绘图PPT (Banana版)

⚠️重要说明（可编辑性）

🧭调用流程

1. 🎨 获取样式/模板列表（`/apps/ppt-banana-style`）

接口说明

请求参数

Header

Body参数（`multipart/form-data`）

请求示例

响应参数

type="style" 响应

type="template" 响应

响应示例

type="style"

type="template"

2. 📥 PPT文档生成（`/apps/ppt-banana`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例