接入前提
获取调用 API 所需的 token 请参考 API 鉴权
本接口导出任务中的大纲或完整内容,返回的是 Markdown 等内容文件地址,不是 PPTX 下载地址。
如果接入方需要下载 PPTX,请先通过 作品生成 创建作品,再调用 作品导出 和 作品导出结果。
调用时机
| 目标 | 是否使用本接口 |
|---|---|
| 导出 Markdown 大纲或完整内容文件 | 是 |
| 下载 PPTX | 否,使用 作品导出 |
| 获取可编辑的大纲树 | 否,使用 获取大纲数据结构 |
响应为 code = 0 且文件地址可以下载,才表示内容导出完成。
响应内容
| 接口描述 | 此接口用于导出大纲或完整内容。 | ||
| 接口地址 | /api/generate/file | 请求方式 | POST |
| 权限校验 | 是 | 请求参数 | json |
请求参数
请求示例
ts
curl --location --request POST 'https://co.aippt.cn/api/generate/file' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>' \
--data-urlencode 'task_id=<taskId>' \
--data-urlencode 'type=1'响应内容
响应示例
ts
{
"code": 0,
"data": "https://aippt-domestic.aippt.com/aippt-api-server/chat/20240129/202401292149336cde4f09a8d24821be38f2296040ad64.md?Expires=1706536473&OSSAccessKeyId=LTAI5tEC4LwH9eYcd5ANuTnS&Signature=KUunmcXyd9r%2FM8VsLNB3B1cJV6I%3D&response-content-disposition=attachment%3Bfilename%2A%3DUTF-8%27%27%25E5%25AE%2598%25E7%25BD%2591-20220221.md",
"msg": "获取成功"
}使用边界
| 目标 | 应使用 |
|---|---|
| 导出大纲或完整内容文件 | 本接口 |
| 导出 PPT 作品文件 | 作品导出 |
| 获取 PPT 合成前的大纲树 | 获取大纲数据结构 |

API 链路