Skip to Content
✨ Ail 智能布局(HTML型PPT)已经可以上线开放平台 立即对接🎁 HTML 转 PPT文件开放能力现已上线 立即体验
API 参考V2 生成流程生成大纲内容

生成大纲内容

接口信息

接口作用

根据任务 ID 为当前任务生成完整的大纲与内容。推荐使用流式响应,以便实时展示生成过程。

请求示例

curl --request POST \ --url https://open.docmee.cn/api/ppt/v2/generateContent \ --header "Content-Type: application/json" \ --header "token: YOUR_TEMP_TOKEN" \ --data '{ "id": "task_xxx", "stream": true, "outlineType": "JSON", "questionMode": false, "isNeedAsk": false, "length": "medium", "scene": "产品介绍", "audience": "客户", "lang": "zh", "prompt": "语气专业", "aiSearch": false, "isGenImg": false }'

请求参数

{ "id": "task_xxx", "stream": true, "outlineType": "JSON", "questionMode": false, "isNeedAsk": false, "length": "medium", "scene": "产品介绍", "audience": "客户", "lang": "zh", "prompt": "语气专业", "aiSearch": false, "isGenImg": false }
  • id:创建任务后获得的任务 ID
  • stream:是否流式返回,默认 true
  • outlineType:大纲格式,常用值为 MDJSON
  • questionMode:是否启用追问模式
  • isNeedAsk:是否需要继续走追问流程
  • lengthshortmediumlong
  • scene:演示场景
  • audience:受众类型
  • lang:输出语言
  • prompt:附加要求,小于 50 字
  • aiSearch:是否启用搜索增强
  • isGenImg:是否允许生成配图

请求字段说明

参数名类型必填示例说明
idstringtask_xxx业务对象 ID。
streambooleantrue是否启用流式返回。
outlineTypestringJSON返回大纲格式。常用值为 MDJSON
questionModebooleanfalse是否启用意图识别与追问流程。
isNeedAskbooleanfalse是否允许服务端继续要求补充信息。
lengthstringmedium字段用途请结合接口场景传入。
scenestring产品介绍演示场景。
audiencestring客户目标受众。
langstringzh输出语言。
promptstring语气专业附加生成要求。
aiSearchbooleanfalse是否启用搜索增强。
isGenImgbooleanfalse是否允许在生成过程中产出图片。

特别说明

prompt 仅在任务类型为 1256 时生效,其他任务类型会忽略该字段。

  • outlineType=JSON 时,最终返回的 result 可直接用于 generatePptxByAi
  • 如果你不接入“意图识别与追问”,推荐显式传入 questionMode=falseisNeedAsk=false

响应方式

  • Content-Type: text/event-stream
  • 逐步返回 data: {...} 分片,status=3 表示仍在生成
  • 生成结束时返回 status=4,并携带完整结构树 result

典型状态

  • 3:生成中
  • 4:生成完成

多语言示例

const response = await fetch('https://open.docmee.cn/api/ppt/v2/generateContent', { method: 'POST', headers: { 'Content-Type': 'application/json', token: 'YOUR_TEMP_TOKEN' }, body: JSON.stringify({ id: 'TASK_ID', stream: true, outlineType: 'JSON', questionMode: false, isNeedAsk: false, length: 'medium', scene: '产品介绍', audience: '客户', lang: 'zh', prompt: '语气专业,适合演示', aiSearch: false, isGenImg: false }) }) console.log(await response.text())

响应示例

data: {"outlineType":"MD","status":3,"text":"#"} data: {"outlineType":"MD","status":3,"text":" 智能决策赋能适老科技公司发展蓝图\n\n## 个人基本情况与核心优势"} data: {"outlineType":"MD","status":4,"result":{"children":[{"level":1,"name":"智能决策赋能适老科技公司发展蓝图","children":[{"level":2,"name":"个人基本情况与核心优势","children":[{"level":3,"name":"个人履历与行业经验","children":[{"level":4,"name":"从业背景与转型经历","children":[{"level":0,"name":"我拥有18年从业经验,其中15年专注于医疗与养老领域。"}]}]}]}]}]},"text":""}

响应字段说明

字段名类型示例说明
data.outlineTypestringMD / JSON返回大纲格式。
data.statusnumber3 / 4生成状态。3 表示生成中,4 表示生成完成。
data.textstring"#"当前分片文本。流式阶段会持续追加,完成时通常为空字符串。
data.resultobject{"children":[...]}最终生成结果。outlineType=MD 时通常是树形 Markdown 结构;outlineType=JSON 时通常是 AIL 可消费的结构化大纲。
data.result.childrenarray[{"level":1,"name":"...","children":[...]}]树形节点列表,节点可递归嵌套。
data.result.children[].levelnumber1 / 2 / 3 / 4 / 0节点层级。1-4 常对应标题层级,0 常为正文段落。
data.result.children[].namestring个人履历与行业经验节点标题或正文内容。
data.result.children[].typestringimage节点类型,可选字段;如为图片节点会出现该字段。
data.result.children[].urlstringhttps://example.com/project-results.jpg资源地址,可选字段(如图片节点)。
Last updated on

© 2023-2026 文多多 AiPPT