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

Docs Map

文档目录

产品介绍选择接入方式先读企业认证 & API Key 获取方式共用
任务状态查询与结果获取必经导出与下载打开编辑器余额查询 / 状态码
首页任务状态查询与结果获取

任务状态查询与结果获取

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

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

接口信息

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

请求参数

参数名类型必填说明
idstring是任务 ID

关键返回字段

字段说明
data.id当前任务 ID
data.progress生成进度
data.status1 进行中,2 已完成,3 失败
data.state_description当前阶段描述
data.images_url已产出的页面缩略图
data.page_count页数
data.preview_url内部预览地址
data.process_url进度页地址

建议判断逻辑

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

轮询建议

  • 前端页面:每 2 到 3 秒一次
  • 服务端批任务:每 5 秒一次
  • 大批量生成:控制最大重试次数和超时