01-描述(主题)一键生成PPT

这是推荐的**“一键生成”方式**：输入一句话/主题，立刻生成完整PPT。
不需要选择模板
不需要设计大纲
不支持自定义结构
适合需要快速出稿或内容测试的场景。

🧭调用流程

1.📥PPT文档生成（`/apps/ppt-create`）

接口说明

接口地址：https://saas.api.yoo-ai.com/apps/ppt-create
请求方式： 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
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
report	bool	N	true - 编辑器异步渲染，获取任务ID后可以直接调用【步骤4-PPT编辑器】，会直接进入生成渲染页面。【⚠️注意】使用异步渲染后，获取结果接口将不会再返回图片数据。	false
ai_watermark	bool	N	是否在PPT封面页展示“AI生成”标识。true=显示，false=不显示。	false

注意：如果设置为true，PPT封面页将展示“AI生成”标识。

请求示例

json

{
    "text":"生成一个人工智能PPT",
    "complex":1,
    "font_name":"幼圆",
    "language":"zh-TW",
    "color":"蓝色",
    "user_name":"张三",
    "ai_picture":false,
    "report":false,
    "ai_watermark":true
}

响应参数

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

在韦尼克平台创建应用获取，刷新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=YsHkZZxxxxxxXR3rXwS

响应参数

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

3.⬇️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":"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

在韦尼克平台创建应用获取，刷新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

请求示例

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

01-描述(主题)一键生成PPT

🧭调用流程

1.📥PPT文档生成（`/apps/ppt-create`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

01-描述(主题)一键生成PPT ​

🧭调用流程 ​

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

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Query参数 ​

请求示例 ​

响应参数 ​

响应示例 ​

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

接口说明 ​

请求参数 ​

Header ​

Body参数（application/json） ​

请求示例 ​

响应参数 ​

响应示例 ​

01-描述(主题)一键生成PPT

🧭调用流程

1.📥PPT文档生成（`/apps/ppt-create`）

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Query参数

请求示例

响应参数

响应示例

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

接口说明

请求参数

Header

Body参数（`application/json`）

请求示例

响应参数

响应示例