获取PPT模版
概述
本文档为获取PPT模版的接口使用文档，获取可用的PPT主题模板列表，包含样式、颜色和预览图信息。
接口定义
| 字段 |
值 |
| Authorization |
Bearer {ApiKey} |
| Content-Type |
application/json |
| X-Appbuilder-Request-Id |
非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数
参数类型：query 参数
| 字段 |
类型 |
必填 |
描述 |
| style |
string |
否 |
按风格筛选，传入风格名称 |
| scene |
string |
否 |
按场景筛选，传入场景名称 |
| color |
string |
否 |
按颜色筛选，传入颜色名称 |
请求示例
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ai_ppt/get_ppt_theme \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "style": "中国风",
7 "color": "红色"
8 }'
筛选维度说明
模板支持三个维度进行筛选，可单独使用或组合使用：
风格分类（style）
| 枚举值 |
说明 |
| 创意趣味 |
创意趣味风格 |
| 年终总结 |
年终总结风格 |
| 卡通手绘 |
卡通手绘风格 |
| 扁平简约 |
扁平简约风格 |
| 文艺清新 |
文艺清新风格 |
| 中国风 |
中国风风格 |
| 企业商务 |
企业商务风格 |
| 未来科技 |
未来科技风格 |
| 文化艺术 |
文化艺术风格 |
场景分类（scene）
| 枚举值 |
说明 |
| 晚会表彰 |
晚会表彰场景 |
| 传统节日 |
传统节日场景 |
| 婚姻爱情 |
婚姻爱情场景 |
| 生日祝福 |
生日祝福场景 |
| 医学科普 |
医学科普场景 |
| 建筑报告 |
建筑报告场景 |
| 工作总结 |
工作总结场景 |
| 年终总结 |
年终总结场景 |
| 工作汇报 |
工作汇报场景 |
颜色分类（color）
| 枚举值 |
说明 |
| 绿色 |
绿色主色调 |
| 蓝色 |
蓝色主色调 |
| 紫色 |
紫色主色调 |
| 橙色 |
橙色主色调 |
| 黄色 |
黄色主色调 |
| 红色 |
红色主色调 |
| 黑色 |
黑色主色调 |
| 白色 |
白色主色调 |
筛选逻辑说明
- 单独使用某一维度：返回该维度下的所有模板
- 组合使用多个维度：取各维度结果的交集，即同时满足所有筛选条件的模板
- 不传任何筛选参数：返回所有可用模板
返回说明
| 字段 |
类型 |
描述 |
| errno |
int |
错误码，成功：0 |
| show_message |
string |
状态描述 |
| request_id |
string |
请求唯一ID |
| data |
object |
返回结果内容 |
| +ppt_themes |
array |
PPT主题列表 |
| ++style_id |
int |
样式ID |
| ++tpl_id |
int |
模板ID |
| ++style_list |
[]string |
风格名称列表 |
| ++color_list |
[]string |
颜色列表 |
| ++scene_list |
[]string |
场景列表 |
| ++main_img_url |
string |
主预览图URL |
| ppt_theme_option |
object |
PPT主题选项，返回所有可选的维度枚举值 |
| +style |
[]string |
可选的风格名称列表 |
| +color |
[]string |
可选的颜色名称列表 |
| +scene |
[]string |
可选的场景名称列表 |
