智能PPT大纲
更新时间：2025-12-19
概述
智能 PPT 大纲基于用户上传的文档自动生成结构清晰的 PPT 大纲，并可按需控制页数，帮助用户快速规划演示内容。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/ai_ppt/generate_outline |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | Bearer {ApiKey} |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| query | string | 是 | 查询内容，用于生成大纲的文本描述 |
| resource_url | string | 否 | 资源文件URL，支持文档、图片等格式（支持格式：doc、pdf、ppt、pptx、png、jpeg、jpg） |
| page_range | string | 否 | PPT生成页数控制，传参枚举值:1-10、11-20、21-30、31-40、40+ 备注：调用本接口后，在生成 PPT 接口中需同时传入本接口返回的 chat_id 和 query_id，才能正确关联上下文并实现 PPT 页数控制功能。 |
| layout | string | 否 | 布局模式，1：简约模式，2：专业模式 |
| language_option | string | 否 | 语言选择，默认default，支持en等 |
| gen_mode | int | 否 | PPT生成模式：1：智能润色；2：严格依从 备注：当前上传图片生成 PPT 暂不支持“严格依从”模式，该模式仅适用于基于文档生成 PPT 的场景。 |
请求示例
Plain Text
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ai_ppt/generate_outline \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "query": "北京旅游规划",
7 "page_range": "1-10",
8 "layout": "2",
9 "language_option": "default",
10 "gen_mode": 1
11}'响应参数
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 请求唯一ID |
| errno | int | 错误码，0：成功 |
| title | string | PPT标题 |
| query | string | 查询内容，用于生成大纲的文本描述 |
| chat_id | int | 会话ID |
| query_id | int | 查询ID，关联大纲生成请求 |
| outline | string | 生成的大纲内容(Markdown格式) |
| is_end | bool | 是否结束 |
| error | string | 错误信息 |
| status | string | 状态说明信息参数：问题理解中，网页检索中，信息总结中，思路整理中，大纲生成中，大纲生成结束； |
响应示例（SSE）
Plain Text
1{
2 "chat_id": 237216140951210,
3 "errno": 0,
4 "is_end": false,
5 "outline": "# 北京旅游规划\n",
6 "query": "北京旅游规划",
7 "query_id": 283210412321210,
8 "request_id": "9097549723349462211",
9 "status": "大纲生成中",
10 "title": "北京旅游规划\n"
11}结果reseponse
Plain Text
1id: 1
2event: message
3data: {"chat_id":"","errno":0,"is_end":false,"outline":"","query":"北京旅游规划","query_id":"","request_id":"9097549723349462211","status":"问题理解中","title":""}
4
5id: 2
6event: message
7data: {"chat_id":"","errno":0,"is_end":false,"outline":"","query":"北京旅游规划","query_id":"","request_id":"9097549723349462211","status":"网页检索中","title":""}
8
9id: 3
10event: message
11data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":"# 北京旅游规划\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
12
13id: 4
14event: message
15data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":"* 北京旅游行程设计\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
16
17id: 5
18event: message
19data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 必游景点推荐与特色介绍\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
20
21id: 6
22event: message
23data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 交通路线与时间安排建议\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
24
25id: 7
26event: message
27data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 餐饮与住宿选择指南","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
28
29id: 8
30event: message
31data: {"chat_id":237216140951210,"errno":0,"is_end":true,"outline":"","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成结束","title":"北京旅游规划\n"}异常响应
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| error | string | 是 | 具体错误信息 |
| request_id | string | 否 | 请求id |
| errorno | int | 是 | 错误码 -1 |
| status | string | 是 | 错误状态 status:failed |
| is_end | bool | 是 | 是否结束 true |