单页生成
接入前提
获取调用 API 所需的 token 请参考 API 鉴权
本接口向已有任务补充一页内容。调用前要有有效的 taskId;它不能替代完整 PPT 的任务创建和内容生成流程。
调用时机
| 场景 | 使用本接口吗 |
|---|---|
| 已有任务中需要补充一页内容 | 是 |
| 从零生成完整 PPT | 否,先走 任务创建 和 智能生成内容获取 |
| 文件或 URL 导入生成 | 否,使用对应导入接口 |
收到 event:close 后,接入方还需把返回的单页内容写回当前任务;仅收到流式文本不代表单页更新完成。
流式返回行为
| 接口描述 | 创建单页 PPT 生成任务并获取任务ID后,调用此接口生成ppt大纲+内容 | ||
| 接口地址 | /api/ai/chat/add/page | 请求方式 | GET |
| 权限校验 | 是 | 请求参数 | json |
| 响应类型 | text/event-stream | ||
请求参数
请求示例
ts
curl --location -g --request GET 'https://co.aippt.cn/api/ai/chat/add/page?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 时,不要把残缺单页合并进任务。确认 taskId 仍有效后重新生成该页。
