⌘K

输入文字主题生成

最常用的创建方式：给一句主题或一段文本，直接生成 PPT 任务。

在线调试

接口说明

POST https://saas.api.yoo-ai.com/apps/ppt-create

请求方式： POST
Content-Type： application/json

适用场景

用户只输入一句主题
已有一段需求说明或业务总结
前端希望做成输入一句话，快速生成的体验

请求参数

Header

参数名	类型	必填	描述	示例值
`Authorization`	string	是	Bearer Token	`Bearer Yoo-xxxxxxxxx`

Body 参数

参数名	类型	必填	描述	默认值
`text`	string	是	请求生成 PPT 文本	-
`complex`	int	否	PPT 复杂度（`1-简单` `2-中等` `3-复杂`）	`1`
`font_name`	string	否	字体（黑体、宋体、仿宋、幼圆、楷书、隶书）	`黑体`
`cover_id`	string	否	模板 ID（通过模板方案选择接口获取）	-
`language`	string	否	`en-US`（英文）、`zh-TW`（繁体中文）	`简体中文`
`color`	string	否	PPT 模板主题色（紫色/红色/橙色/黄色/绿色/青色/蓝色/粉色）	`随机`
`user_name`	string	否	作者名	`尤小优`
`ai_picture`	bool	否	是否使用 AI 生成图片	`false`
`report`	bool	否	`true` 表示走编辑器异步渲染，获取任务 ID 后可以直接调用打开编辑器接口；启用后，获取结果接口将不会再返回图片数据	`false`

请求示例

最小请求示例

{
  "text": "生成一份新能源汽车行业趋势分析 PPT"
}

完整请求示例

{
  "text": "生成一个人工智能PPT",
  "complex": 1,
  "font_name": "幼圆",
  "cover_id": "6JCxtc-0",
  "language": "zh-TW",
  "color": "蓝色",
  "user_name": "张三",
  "ai_picture": false
}

响应参数

参数名	类型	描述
`code`	integer	状态码
`msg`	string	响应消息
`data`	object	数据体
`data.id`	string	任务 ID

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "任务ID"
  }
}

返回结果中的 data.id 为任务主键。创建成功后，后续流程进入查询任务进度 /ppt-result；任务完成后可继续跳转至下载 PPT /ppt-download 或打开编辑器 /ppt-editor。

使用说明

创建成功仅表示任务已受理，不代表 PPT 已生成完成。
建议在业务系统中持久化保存 data.id，用于后续查询、下载和编辑。
如需先选择模板，可先调用模板方案选择接口获取 cover_id，再在本接口中传入。
如果 report=true，获取任务 ID 后可以直接调用打开编辑器接口进入生成渲染页面。
启用 report=true 后，获取结果接口将不再返回图片数据。