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

Docs Map

文档目录

产品介绍选择接入方式先读企业认证 & API Key 获取方式共用
API 接口说明先看基础接入示例流程先看异步接口说明发起生成任务二次处理与辅助能力
首页发起生成任务

发起生成任务

说明不同生成入口的适用场景,以及创建接口与后续异步查询链路之间的关系。

上一页
异步接口说明
下一页
二次处理与辅助能力

这一页只解决一个问题:不同生成场景应该从哪个创建接口开始。

所有创建接口在成功后都会返回任务 id,后续统一进入结果查询链路。完整处理方式请先参考基础接入示例流程。

生成入口怎么选

场景推荐接口什么时候最适合
一句话主题、长文本、MarkdownPOST /apps/ppt-create最常见,适合大多数业务接入
已有 PDF / Word / TXT 等材料POST /apps/ppt-create-file希望直接基于已有文件生成
学术答辩、论文演示POST /apps/ppt-create-thesis需要论文答辩专用结构
先出大纲,再确认生成POST /apps/ppt-structure + POST /apps/ppt-create企业客户、人工审核场景更友好
使用企业模板或品牌资产POST /apps/ppt-company-create强调品牌统一与模板复用
绘图风格、封面、模板扩展参考“更多生成方案”已跑通主流程后再接更稳妥

典型选择方式

1. 想最快接入一条主流程

  • 先选 POST /apps/ppt-create
  • 最适合先验证主题生成是否符合预期
  • 适合大多数首次联调场景

2. 已经有原始材料文件

  • 选 POST /apps/ppt-create-file
  • 适合直接基于 PDF、Word、TXT 等已有内容生成
  • 更适合资料已经沉淀好的客户

3. 场景明确是论文答辩

  • 选 POST /apps/ppt-create-thesis
  • 适合对答辩结构、章节表达有专门要求的场景

4. 客户必须先确认结构

  • 先走 POST /apps/ppt-structure
  • 客户确认大纲后再走 POST /apps/ppt-create
  • 更适合企业汇报、方案类、需要人工审核的项目

5. 强调品牌统一和模板复用

  • 选 POST /apps/ppt-company-create
  • 适合企业模板、品牌资产、标准化交付要求更强的客户

响应结果关注字段

大多数创建接口在成功返回后,建议优先关注以下结果:

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "任务ID"
  }
}

data.id 不代表最终成品地址,而是后续查询、下载、编辑和增强处理时需要持续使用的任务标识。

接入建议

  1. 第一次联调时,先只接一种主入口,不要同时接全部生成方式。
  2. 优先跑通“创建 -> 查询 -> 下载”的最短闭环,再扩展编辑器或增强能力。
  3. 如果客户对内容结构敏感,优先采用“先生成大纲、再正式生成”的两步法。
  4. 如果你要做企业交付,模板生成通常比纯文本生成更容易被接受。

相关文档

  • 想先跑通全链路:继续看基础接入示例流程
  • 想理解为什么是异步:继续看异步接口说明
  • 想做主题生成:继续看输入文字主题生成
  • 想做文件生成:继续看上传文件生成(PDF / Word)
  • 想让客户先确认结构:继续看自定义大纲生成
  • 想做品牌模板输出:继续看企业模板生成