韦尼克API文档

Appearance

基于论文生成答辩PPT ​

适用场景 ​

  • 上传论文文件，支持PDF、doc、docx格式，解析论文文件，生成答辩PPT

    Tip:

    单次文件字数上限为35000，超过部分会自动进行截断

步骤1：通过论文生成PPT ​

1.说明 ​

接口描述通过文件生成PPT
请求地址https://saas.api.yoo-ai.com/apps/ppt-create-thesis请求方式POST

2.请求参数 ​

Headers

  • Token需要在韦尼克平台创建相关应用获取
名称类型必选说明示例值
Authorizationstring是Authorization - Bearer TokenBearer Yoo-xxxxxxxxx

Body请求参数

参数类型必须说明
file_keystring是文件url
stylestring否风格 科技/商务/小清新/可爱卡通/中国风/极简/党政
colorstring否颜色 紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色
titlestring否标题 优先自定义，为空使用解析结果标题
pleaderstring否汇报人 为空默认尤小优
advisorstring否指导老师 为空默认尤小优
schoolstring否学校
school_logostring否学校logo
school_picturestring否学校图片

3.请求示例 ​

Body请求参数

JSON
{
    "file_key":"http://image.yoojober.com/users/chatppt/temp/2024-06/6672aa839a9da.docx",
    "style":"科技",
    "color":"蓝色",
    "title":"",
    "pleader":"",
    "advisor":"",
    "school":"北京大学",
    "school_logo":"",
    "school_picture":""
}

4.响应内容 ​

名称类型参数描述参数示例
codeint状态码
msgstring返回信息
datastring数据体
data.idarray生成任务ID

5.响应示例 ​

JSON
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "2DBH5GNc8EkZTuwUPqkM9Hg7n2SjDJQf"
    }
}

步骤2.获取PPT生成结果 ​

1.说明 ​

接口描述获取PPT生成状态和预览页
请求地址https://saas.api.yoo-ai.com/apps/ppt-result请求方式GET

2.请求参数 ​

Headers

  • Token需要在韦尼克平台创建相关应用获取
名称类型必选说明示例值
Authorizationstring是Authorization - Bearer TokenBearer Yoo-xxxxxxxxx

Query参数

名称类型必选说明
idstring是任务ID

3.请求示例 ​

JSON
{
    "id":"acQdp8mesqQUmpQqkVHRMRffWyW7PqsW"
}

4.响应内容 ​

名称类型描述
codeint响应状态码，200表示请求成功
msgstring响应消息，"success"表示请求成功
dataobject包含PPT相关信息的数据对象
idstring任务ID
images_urlarray包含PPT中所有图片的URL和时间戳的数组
images_url.urlstringPPT图片预览地址
images_url.timestringPPT图片生成时间戳
note_statusintPPT备注状态，0-无备注，1-有备注
introducestringPPT的大纲
ppt_titlestringPPT的标题
page_countintPPT的页数
progressint生成进度，100表示已完成
statusint状态(1-进行中 2-已完成 3-生成失败)
first_image_up_atstring第一张图片上传的时间
created_atstringPPT创建的时间
updated_atstringPPT最后更新的时间
state_descriptionstring状态描述，"生成已完成"、"正在生成演示内容"
process_urlstring生成进度的URL
preview_urlstringPPT预览的URL

5.响应示例 ​

json
{
    "code": 200,
    "msg": "success",
    "data": {
        "id": "EvqVxaZtAdugkDbZP3XHs27NTUKHETam",
        "images_url": [
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc2702bb8.png",
                "time": 1734593575
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc28ef1d8.png",
                "time": 1734593577
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc29aa7b8.png",
                "time": 1734593577
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc3a7ef97.png",
                "time": 1734593594
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4482bad.png",
                "time": 1734593604
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc459533b.png",
                "time": 1734593605
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc2b8e268.png",
                "time": 1734593580
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc46d1c17.png",
                "time": 1734593607
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc47da508.png",
                "time": 1734593608
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4914daf.png",
                "time": 1734593609
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc2e61abb.png",
                "time": 1734593582
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc49e9079.png",
                "time": 1734593610
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4b4143d.png",
                "time": 1734593611
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4c1dd44.png",
                "time": 1734593612
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc2f7e7c6.png",
                "time": 1734593583
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4d42ec0.png",
                "time": 1734593613
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4e142a4.png",
                "time": 1734593614
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc4f97409.png",
                "time": 1734593615
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc31c152b.png",
                "time": 1734593586
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc504f8ae.png",
                "time": 1734593616
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc5199932.png",
                "time": 1734593617
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc526eefc.png",
                "time": 1734593618
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc3393f0c.png",
                "time": 1734593587
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc539df8a.png",
                "time": 1734593619
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc54a1049.png",
                "time": 1734593620
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc55a7fda.png",
                "time": 1734593621
            },
            {
                "url": "https://file.static.yoojober.cn/chatppt/20241219/6763cc5608730.png",
                "time": 1734593622
            }
        ],
        "note_status": 0,
        "introduce": "智能办公：ChatPPT的智能生成与辅助功能\r\nChatPPT的基本概念\r\n智能生成与编辑幻灯片\r\nAI大模型的应用\r\n提高工作效率的优势\r\nChatPPT的基本概念\r\n自然语言处理技术\r\n图像识别与提取\r\n机器学习算法应用\r\nChatPPT的基本概念\r\n从内测到公测\r\nPlus版本与插件\r\n重要时间节点\r\nChatPPT的基本概念\r\n企业人士的益处\r\n教育者的实践应用\r\n学生的便捷体验\r\nChatPPT的基本概念\r\n节省时间和精力\r\n专业级幻灯片制作\r\n适应多种场合\r\nChatPPT的基本概念\r\n技术创新与优化\r\n市场需求与产品发展\r\n跨界融合的可能性\r\n",
        "ppt_title": "智能办公：ChatPPT的智能生成与辅助功能",
        "page_count": 27,
        "progress": 100,
        "status": 2,
        "first_image_up_at": "2024-12-19 15:32:55",
        "created_at": "2024-12-19 15:32:07",
        "updated_at": "2024-12-19 15:33:44",
        "state_description": "生成已完成...",
        "process_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=EvqVxaZtAdugkDbZP3XHs27NTUKHETam",
        "preview_url": "https://chatppt.test.yoo-ai.com/generateResults?generateID=EvqVxaZtAdugkDbZP3XHs27NTUKHETam"
    }
}

步骤3：获取PPT下载地址 ​

1.说明 ​

接口描述获取PPT下载链接
请求地址https://saas.api.yoo-ai.com/apps/ppt-download请求方式GET

2.请求参数 ​

Headers

  • Token需要在韦尼克平台创建相关应用获取
名称类型必选说明示例值
Authorizationstring是Authorization - Bearer TokenBearer Yoo-xxxxxxxxx

query参数

参数类型必须默认值说明
idstring是PPT生成ID
typestring是pptx下载的文件格式

3.请求示例 ​

  • 下载PPTX格式示例：
{
  "id":"BTs3qWzWaFpjRbyz5ZGfAR6SMnSPYyyB",
  "type":"pptx"
}

4.响应内容 ​

名称类型参数描述参数示例
codeint状态码
msgstring描述消息
dataobject数据体
data.download_urlstring下载链接

5.响应示例 ​

json
{
  "code": 200,
  "msg": "success",
  "data":{
      "download_url":"https://download.yoojober.com/chatppt_business/2024-06/86b26b64cb6ebf7565523c9192f467a2.pptx?e=1717675120&token=8_2qFlGEVQZPpFvHdGR6gg2t9A9QZfWT9wwTl92s:cbgbknWpC2QuLzn2zqFDHjifCA4="
      }
}