创建智能PPT大纲
更新时间：2026-05-07
POST
https://qianfan.baidubce.com/v2/tools/ai_ppt/generate_outline
本接口基于用户上传的文档自动生成结构清晰的PPT大纲，支持页数控制和多种布局模式，帮助快速规划演示内容。
该组件为付费功能，具体计费说明请参见使用文档。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
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
integer
PPT生成模式。当前上传图片生成PPT暂不支持"严格依从"模式，该模式仅适用于基于文档生成PPT的场景。可选值：1（智能润色）、2（严格依从）。
可选
请求结构
POST /v2/tools/ai_ppt/generate_outline HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"query": "北京旅游规划",
"resource_url": "https://example.com/doc.pdf",
"page_range": "1-10",
"layout": "2",
"language_option": "default",
"gen_mode": 1
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/tools/ai_ppt/generate_outline" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"query": "北京旅游规划",
"page_range": "1-10",
"layout": "2",
"language_option": "default",
"gen_mode": 1
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
request_id
string
请求唯一ID。
可选
errno
integer
错误码，0 表示成功。
可选
title
string
PPT标题。
可选
query
string
查询内容，用于生成大纲的文本描述。
可选
chat_id
integer
会话ID。
可选
query_id
integer
查询ID，关联大纲生成请求。
可选
outline
string
生成的大纲内容（Markdown格式）。
可选
is_end
boolean
是否已结束生成。
可选
error
string
错误信息。
可选
status
string
状态说明信息。可选值：问题理解中、网页检索中、信息总结中、思路整理中、大纲生成中、大纲生成结束。
可选
成功响应
{
"chat_id": 237216140951210,
"errno": 0,
"is_end": false,
"outline": "# 北京旅游规划\n",
"query": "北京旅游规划",
"query_id": 283210412321210,
"request_id": "9097549723349462211",
"status": "大纲生成中",
"title": "北京旅游规划"
}
结果reseponse
id: 1
event: message
data: {"chat_id":"","errno":0,"is_end":false,"outline":"","query":"北京旅游规划","query_id":"","request_id":"9097549723349462211","status":"问题理解中","title":""}
id: 2
event: message
data: {"chat_id":"","errno":0,"is_end":false,"outline":"","query":"北京旅游规划","query_id":"","request_id":"9097549723349462211","status":"网页检索中","title":""}
id: 3
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":"# 北京旅游规划\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
id: 4
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":"* 北京旅游行程设计\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
id: 5
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 必游景点推荐与特色介绍\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
id: 6
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 交通路线与时间安排建议\n","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
id: 7
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":false,"outline":" * 餐饮与住宿选择指南","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成中","title":"北京旅游规划\n"}
id: 8
event: message
data: {"chat_id":237216140951210,"errno":0,"is_end":true,"outline":"","query":"北京旅游规划","query_id":283210412321210,"request_id":"9097549723349462211","status":"大纲生成结束","title":"北京旅游规划\n"}
评价此篇文章