生成大纲内容
接口信息
- 方法:POST
- 路径:
- 鉴权:请求头传
token
接口作用
根据任务 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:创建任务后获得的任务 IDstream:是否流式返回,默认trueoutlineType:大纲格式,常用值为MD或JSONquestionMode:是否启用追问模式isNeedAsk:是否需要继续走追问流程length:short、medium、longscene:演示场景audience:受众类型lang:输出语言prompt:附加要求,小于 50 字aiSearch:是否启用搜索增强isGenImg:是否允许生成配图
请求字段说明
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
id | string | 是 | task_xxx | 业务对象 ID。 |
stream | boolean | 否 | true | 是否启用流式返回。 |
outlineType | string | 否 | JSON | 返回大纲格式。常用值为 MD 和 JSON。 |
questionMode | boolean | 否 | false | 是否启用意图识别与追问流程。 |
isNeedAsk | boolean | 否 | false | 是否允许服务端继续要求补充信息。 |
length | string | 否 | medium | 字段用途请结合接口场景传入。 |
scene | string | 否 | 产品介绍 | 演示场景。 |
audience | string | 否 | 客户 | 目标受众。 |
lang | string | 否 | zh | 输出语言。 |
prompt | string | 否 | 语气专业 | 附加生成要求。 |
aiSearch | boolean | 否 | false | 是否启用搜索增强。 |
isGenImg | boolean | 否 | false | 是否允许在生成过程中产出图片。 |
特别说明
prompt 仅在任务类型为 1、2、5、6 时生效,其他任务类型会忽略该字段。
- 当
outlineType=JSON时,最终返回的result可直接用于generatePptxByAi。 - 如果你不接入“意图识别与追问”,推荐显式传入
questionMode=false和isNeedAsk=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.outlineType | string | MD / JSON | 返回大纲格式。 |
data.status | number | 3 / 4 | 生成状态。3 表示生成中,4 表示生成完成。 |
data.text | string | "#" | 当前分片文本。流式阶段会持续追加,完成时通常为空字符串。 |
data.result | object | {"children":[...]} | 最终生成结果。outlineType=MD 时通常是树形 Markdown 结构;outlineType=JSON 时通常是 AIL 可消费的结构化大纲。 |
data.result.children | array | [{"level":1,"name":"...","children":[...]}] | 树形节点列表,节点可递归嵌套。 |
data.result.children[].level | number | 1 / 2 / 3 / 4 / 0 | 节点层级。1-4 常对应标题层级,0 常为正文段落。 |
data.result.children[].name | string | 个人履历与行业经验 | 节点标题或正文内容。 |
data.result.children[].type | string | image | 节点类型,可选字段;如为图片节点会出现该字段。 |
data.result.children[].url | string | https://example.com/project-results.jpg | 资源地址,可选字段(如图片节点)。 |
Last updated on