Skip to content

04-基于文件生成PPT

支持用户上传MarkDown、word、PDF、XMind、FreeMind、TXT 等文档文件,系统自动分析结构并生成对应的演示型 PPT。无需手动输入大纲,适合快速将现有文稿转化为 PPT 格式。

📌 使用前提

  • 用户需准备格式规范的文档文件(MarkDown、word、PDF、XMind、FreeMind、TXT)
  • 可选传入 cover_id 指定模板封面(如未传则随机选择)

🧭调用流程

1.📄文件生成PPT(/apps/ppt-create-file

接口说明

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

请求参数

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

参数名类型描述示例值
AuthorizationstringAuthorization - Bearer TokenBearer Yoo-xxxxxxxxx
  • Body参数(application/json

参数名类型必填描述默认值
file_urlstringY文件URL
user_namestringN作者名尤小优

请求示例

json
{
    "file_url":"https://saas.file.yoo-ai.com/20250115/f2025011-5150-7336-a5a3-c46772815112.doc",
    "user_name":"作者名称"
}

响应参数

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

响应示例

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

2. 🔄 获取生成PPT结果(/apps/ppt-result

接口说明

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

请求参数

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

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

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

请求示例

json
{
    "id":"rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw"
}

响应参数

参数名类型描述
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": "rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/tggalqdyx9qmy.png",
                "time": 1748592131
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/6qr38zg0z68mw.png",
                "time": 1748592131
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/6wau8fpbk22nd.png",
                "time": 1748592132
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/dx88nihijqg2x.png",
                "time": 1748592137
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/d256fhcv1ck8c.png",
                "time": 1748592140
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/4xzrvzp590grp.png",
                "time": 1748592140
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/vv6yztoanyofb.png",
                "time": 1748592133
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/8czwumw4owpti.png",
                "time": 1748592140
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/9j8axlh1wupor.png",
                "time": 1748592141
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/7mcimv1yfhrc5.png",
                "time": 1748592141
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/lpmac433jg7fi.png",
                "time": 1748592134
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/ilbwb9fy0m0bp.png",
                "time": 1748592141
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/xzox8q604fxxb.png",
                "time": 1748592142
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/lhe3mju8m7i72.png",
                "time": 1748592142
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/kvlm60d4ljttv.png",
                "time": 1748592135
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/0k2vz4tx4mu9h.png",
                "time": 1748592142
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/pyzix4b9lsipo.png",
                "time": 1748592142
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/zr0218wtd3pm2.png",
                "time": 1748592142
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/en97fpq80ws1g.png",
                "time": 1748592136
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/zvndszlhzwjhy.png",
                "time": 1748592143
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/9ygka4m8occnx.png",
                "time": 1748592143
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/3p0v7uhzybakz.png",
                "time": 1748592143
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20250530/tcsryupyi1bp8.png",
                "time": 1748592143
            }
        ],
        "note_status": 0,
        "introduce": "ChatPPT:智能生成PPT的AI工具\r\n产品介绍与定位\r\nChatPPT概述\r\n智能生成技术\r\n一键智能体验\r\n产品介绍与定位\r\n自动生成幻灯片\r\n图像与语音转换\r\n机器学习模板学习\r\n产品介绍与定位\r\nChatPPT版本更新\r\n受众群体划分\r\n满足多样化需求\r\n产品介绍与定位\r\n智能对话式输入\r\n多样化的生成方式\r\n丰富的美化与导出功能\r\n产品介绍与定位\r\n高效便捷的制作过程\r\n个性化定制选项\r\n全面的功能满足用户需求\r\n",
        "ppt_title": "ChatPPT:智能生成PPT的AI工具",
        "page_count": 23,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2025-05-30 16:02:11",
        "created_at": "2025-05-30 16:01:24",
        "updated_at": "2025-05-30 16:02:25",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw",
        "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=rgxu8xn4DqJuVsGvrC43aq9KDJxnM2Xw"
    }
}

3.⬇️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下载链接

响应示例

4.json
{
    "code": 200,
    "msg": "success",
    "data": {
        "download_url": "https://yoo-web-public.gz.bcebos.com/chatppt/20250530/v8henckb941vc.pptx?authorization=bce-auth-v1%2FALTAK7YW57hmnPzhWsz3GT3DUV%2F2025-05-30T08%3A11%3A55Z%2F3600%2F%2F92b9e431a1e07d5e5cb02759aa45bb1511745ad3c6b8df64717cba6f7a995146"
    }
}

4.🛠️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

请求示例

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