韦尼克 Logo
韦尼克平台
AI Document Platform
⌘K
开发文档API 调试台AI接入助手

Docs Map

文档目录

产品介绍选择接入方式先读企业认证 & Token 获取方式共用
任务状态查询与结果获取必经导出与下载打开编辑器
收费标准
首页任务状态查询与结果获取

查询任务进度 /ppt-result

所有生成链路都会回到这里:查询任务进度、状态、预览与交付前置信息。

在线调试
上一页
模板封面生成
下一页
导出与下载

接口说明

GET https://saas.api.yoo-ai.com/apps/ppt-result?id={id}
  • 请求方式: GET

请求参数

Header

参数名类型必填描述示例值
Authorizationstring是Authorization - Bearer TokenBearer Yoo-xxxxxxxxx

Query 参数

参数名类型必填描述默认值
idstring是任务 ID-

请求示例

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

响应参数

参数名类型描述
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,仅用于内部测试预览

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e",
    "images_url": [
      {
        "url": "https://file.static.yoojober.cn/chatppt/20250529/yyw5p1cytogfs.png",
        "time": 1748508229
      },
      {
        "url": "https://file.static.yoojober.cn/chatppt/20250529/5c46x4daeeelk.png",
        "time": 1748508234
      }
    ],
    "note_status": 0,
    "introduce": "機器學習科技的突破方向\r\n算灋模型創新\r\n深度學習模型優化\r\n强化學習在複雜任務應用\r\n聯邦學習保障資料安全\r\n",
    "ppt_title": "機器學習科技的突破方向",
    "page_count": 27,
    "progress": 100,
    "status": 2,
    "first_image_up_at": "2025-05-29 16:43:49",
    "created_at": "2025-05-29 16:42:56",
    "updated_at": "2025-05-29 16:45:58",
    "state_description": "生成已完成...",
    "process_url": "https://chatppt.yoo-ai.com/generateResults?generateID=cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e",
    "preview_url": "https://chatppt.yoo-ai.com/generateResults?generateID=cuymb9QUQ6BEuPGp3FKH8ZmxQzGVVM6e"
  }
}

建议判断逻辑

if (status === 2) {
  // 开放下载或编辑
} else if (status === 3) {
  // 提示失败并允许重试
} else {
  // 继续轮询
}

轮询建议

  • 前端页面:每 2 到 3 秒一次
  • 服务端批任务:每 5 秒一次
  • 大批量生成:控制最大重试次数和超时
  • 调用时必须携带 Authorization,否则会返回“缺少 AccessToken”