mindshow api接口文档

Markdown转PPT接口

---

1. 接口概述

提交一段 Markdown，即可在线生成 .pptx 幻灯片。接口返回一次性下载 URL（含访问令牌）以及文档标题。

注意：测试渠道码请联系support@mindshow.fun

---

2. 请求信息

项目	说明
请求方法	POST
请求 URL	https://pptapi.mindshow.ai/md2ppt
Content-Type	application/json; charset=utf-8

2.1 请求体（JSON）

字段	类型	必填	说明
markdown	string	✅	完整 Markdown 文本（UTF-8），建议 ≤ 200 KB
channeluser	string	✅	调用方标识（如手机号 / 用户 ID）
channel	string	✅	渠道标识
isAutoLayout	string		默认自动布局，如果不需要设为0
useThemeId	string		默认使用随机布局，可以指定使用特定themeid的模板
meta	object		可选的扩展元数据，sub_title：自定义副标题、speaker：演讲人、speaker_time：演讲时间；animation：动画方式，可以选择"click"或者"page"方式，click为点击播放，page为自动播放，默认无动画。

示例

    {
      "markdown": "# 英文元音教学\n\n## 概述\nN元音…",
      "channeluser": "1234567890",
      "channel": "mindshow",
      "meta": {
      "sub_title": "小标题自定义",
      "speaker": "dennis",
      "speaker_time": "2025-09-29",
      "animation": "page"
      }
    }

---

3. 响应信息

3.1 成功响应（HTTP 200）

字段	类型	说明
downloadurl	string	PPTX 下载地址（默认 30分钟内有效）
doctitle	string	按首级标题或文件名生成的标题

示例

    {
      "downloadurl": "https://download.mindshow.fun/12345?token=67890&lang=zhCN",
      "doctitle": "英文元音教学",
      "success": true
    }

请在有效期内下载；失效后需重新调用生成接口。

获取模板主题列表 API 接口

---

1. 接口概述

获取 Mindshow 系统内置的 PPT 模板主题列表。支持分页查询、按风格 / 场景 / 语言等多维度筛选。

---

2. 请求信息

项目	说明
请求方法	GET
请求 URL	https://pptapi.mindshow.ai/gettheme
Content-Type	application/x-www-form-urlencoded

2.1 请求参数（Query）

以下所有参数均为可选，仅填写你需要筛选的字段。

字段	类型	说明
index	number	页码，从 1 开始（默认 1）
limit	number	每页条数（默认 20）
language	string	语言：ZH 中文、EN 英文，默认显示全部，海外建议使用EN，这样会过滤党政相关的模板
style	string[]	风格，如 business、flat、technology 等
scene	string[]	场景，如 summary、proposal、training 等
color	string[]	主色调，如 red、blue、green 等
detail	string	按中文描述搜索
detail_en	string	按英文描述搜索
title	string	按主题标题搜索

示例

https://pptapi.mindshow.ai/gettheme?language=ZH&limit=10&order=TIME&style=business&scene=summary

---

3. 响应信息

3.1 成功响应（HTTP 200）

响应为一个对象，包含分页信息以及已过滤字段的主题数组：

▶ 返回字段结构：

字段	类型	说明
total	number	总条数
page	number	当前页码
totalPage	number	总页数
pageSize	number	每页大小
offset	number	当前偏移量（一般为 (page-1)*pageSize）
data	object[]	主题列表，每项为主题对象（已过滤字段）

▶ 每个主题对象字段如下（字段已过滤）：

字段	类型	说明
id	number	主题唯一标识
title	string	主题标题
detail	string	中文描述
detailEn	string	英文描述
image	string	封面图地址
color	string	主题主色，如 blue、green
style	string	风格，如 business、flat 等
scene	string	场景，如 summary、proposal 等
createTime	string	创建时间

示例

{
  "total": 64,
  "page": 1,
  "totalPage": 4,
  "pageSize": 20,
  "offset": 0,
  "data": [
    {
      "id": 101,
      "title": "科技蓝调",
      "detail": "适用于产品发布、科技演示等场景",
      "detailEn": "For tech demos and launches",
      "image": "https://cdn.mindshow.fun/theme/101.png",
      "color": "blue",
      "style": "technology",
      "scene": "proposal",
      "createTime": "2025-06-20 14:02:57"
    }
  ]
}

---

3.2 异常响应

状态码	含义	说明
401	Unauthorized	未授权或未登录
404	Not Found	接口不存在
500	Internal Error	服务器错误
502	Bad Gateway	接口服务响应异常（上游不可达或响应无效）

---