参考文档导入生成内容获取
接入前提
获取调用 API 所需的 token 请参考 API 鉴权
用户提供参考资料并希望围绕资料生成 PPT 时,先创建参考文档任务,再用本接口接收流式 Markdown。Word 主文档和普通文件走各自的导入接口。
调用时机
| 场景 | 使用本接口吗 |
|---|---|
| 用户上传参考资料,希望围绕参考资料生成 PPT | 是 |
| 用户上传 Word 类主文档 | 否,使用 上传 Word |
| 用户上传 XMind、FreeMind、Markdown 文件 | 否,使用 上传普通文件 |
参考资料处理完成时会收到 event:close。此前返回的 Markdown 片段需要按顺序拼成完整内容。
流式返回行为
| 接口描述 | 用户通过参考文档输入标题和上传word、pdf、txt进行创建任务实现智能生成内容 | ||
| 接口地址 | /api/ai/chat/refer | 请求方式 | GET |
| 权限校验 | 是 | 请求参数 | json |
| 响应类型 | text/event-stream | ||
请求参数
请求示例
ts
curl --location -g --request GET 'https://co.aippt.cn/api/ai/chat/refer?task_id=<taskId>' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>'响应内容
响应示例
ts
event:message
data:{"content":"``"}
event:message
data:{"content":"`\n"}
event:message
data:{"content":"#"}
event:message
data:{"content":" 业"}
......
event:message
data:{"content":"```"}
event:close
data:api-close参考资料处理完成后
流式内容接收完成后,接入方可以继续调用 获取大纲数据结构,或进入 作品 生成和导出 PPT。
连接中断且没有 event:close 时,当前 Markdown 不完整。重新调用接口前先确认参考文档任务仍然有效。
