星火AI-智能PPT生成 API 文档

🕗 发布于 2024-09-21 05:50 powerpoint 星火AI AIGC

智能PPT生成 API 文档 | 讯飞开放平台文档中心

接口与鉴权

#接口Demo

部分开发语言Demo如下，其他开发语言请参照文档进行开发，欢迎大家到讯飞开放平台社区交流集成经验。

智能PPT生成API Demo java语言
 智能PPT生成API Demo python语言

#接口域名

zwapi.xfyun.cn

#获取签名

在HTTP请求头 header 中设置参数：appId, timestamp, signature

String appId = "应用ID";
String secret = "应用的秘钥";
long timestamp = System.currentTimeMillis()/1000;
String signature = ApiAuthAlgorithm.getSignature(appId, secret, timestamp);

request.setHeader("appId",appId);
request.setHeader("timestamp",timestamp);
request.setHeader("signature",signature);

字段名	类型	描述	必须
appId	String	应用ID	Y
timestamp	Long	时间戳，单位: s，与服务端时间相差五分钟之内	Y
signature	String	签名	Y

#DEMO

ApiAuthAlgorithm.class 鉴权类

public class ApiAuthAlgorithm {

    private static final char[] MD5_TABLE = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};

    /**
     * 获取签名
     *
     * @param appId    签名的key
     * @param secret 签名秘钥
     * @return 返回签名
     */
    public String getSignature(String appId, String secret, long ts) {
        try {
            String auth = md5(appId + ts);
            return hmacSHA1Encrypt(auth, secret);
        } catch (SignatureException e) {
            return null;
        }
    }

    /**
     * sha1加密
     *
     * @param encryptText 加密文本
     * @param encryptKey  加密键
     * @return 加密
     */
    private String hmacSHA1Encrypt(String encryptText, String encryptKey) throws SignatureException {
        byte[] rawHmac;
        try {
            byte[] data = encryptKey.getBytes(StandardCharsets.UTF_8);
            SecretKeySpec secretKey = new SecretKeySpec(data, "HmacSHA1");
            Mac mac = Mac.getInstance("HmacSHA1");
            mac.init(secretKey);
            byte[] text = encryptText.getBytes(StandardCharsets.UTF_8);
            rawHmac = mac.doFinal(text);
        } catch (InvalidKeyException e) {
            throw new SignatureException("InvalidKeyException:" + e.getMessage());
        } catch (NoSuchAlgorithmException e) {
            throw new SignatureException("NoSuchAlgorithmException:" + e.getMessage());
        }
        return new String(Base64.encodeBase64(rawHmac));
    }

    private String md5(String cipherText) {
        try {
            byte[] data = cipherText.getBytes();
            // 信息摘要是安全的单向哈希函数，它接收任意大小的数据，并输出固定长度的哈希值。
            MessageDigest mdInst = MessageDigest.getInstance("MD5");

            // MessageDigest对象通过使用 update方法处理数据， 使用指定的byte数组更新摘要
            mdInst.update(data);

            // 摘要更新之后，通过调用digest（）执行哈希计算，获得密文
            byte[] md = mdInst.digest();

            // 把密文转换成十六进制的字符串形式
            int j = md.length;
            char[] str = new char[j * 2];
            int k = 0;
            for (byte byte0 : md) { // i = 0
                str[k++] = MD5_TABLE[byte0 >>> 4 & 0xf]; // 5
                str[k++] = MD5_TABLE[byte0 & 0xf]; // F
            }
            // 返回经过加密后的字符串
            return new String(str);
        } catch (Exception e) {
            return null;
        }
    }
}

#错误码

错误码	描述	处理方式
20002	参数错误	确认接口入参
20005	大纲生成失败	查看是否存在敏感词汇，尝试重新生成
20006	PPT生成失败	PPT导出错误，请重新生成或联系技术人员
20007	鉴权错误	检查鉴权信息
9999	系统异常	确认鉴权信息、请求方式、请求参数是否有误，或联系技术人员排查相关日志

#接口列表

#1 PPT生成（直接根据用户输入要求，获得最终PPT）

1.1 接口描述：

基于用户提示、要求等相关内容生成PPT，字数不得超过8000字。

1.2 接口地址：

https://zwapi.xfyun.cn/api/aippt/create

1.3 请求查询参数：

POST，application/json

名称	类型	描述	必须	默认值
query	String	用户生成PPT要求（最多8000字）	Y
create_model	String	PPT生成类型：文本生成、话题生成、程序判断(默认)	N	auto
theme	String	PPT生成主题：随机主题(默认)、紫影幽蓝……	N	auto
business_id	String	业务ID（非必传）- 业务方自行决定是否使用	N
author	String	PPT作者名：用户自行选择是否设置作者名	N	智文
is_card_note	Bool	是否生成PPT演讲备注	N	false
is_cover_img	Bool	是否需要封面图	N	false
language	String	语种	N	cn
is_figure	Bool	是否自动配图	N	false

1.4 可选参数列表：

create_model：
- auto：自动，由程序自行判断；
- topic：话题生成（建议150字以内）
- text：文本生成，基于长文本生成
theme（详细信息可通过主题查询接口获得）：
- auto：自动，随机主题
- purple：紫色主题
- green：绿色主题
- lightblue：清逸天蓝
- taupe：质感之境
- blue：星光夜影
- telecomRed：炽热暖阳
- telecomGreen：幻翠奇旅
language：
- cn：中文（简体）
- en：英语
- ja：日语
- ru：俄语
- ko：韩语
- de：德语
- fr：法语
- pt：葡萄牙语
- es：西班牙语
- it：意大利语
- th：泰语

1.5 请求响应：

{
    "code":0,
    "desc":"成功",
    "data":{
    "sid":"zhiwen@xxxxxxxxxxxxxxxxxxxxx",// 请求唯一ID
        "coverImgSrc":"xxxxxxxxxxxxxx",// 封面地址
        "title" : "xxx",// 主标题
        "subTitle" : "xxx"// 副标题
    }
}

1.6 响应描述

响应字段	类型	描述
code	int	错误码
desc	string	错误详情
data.sid	string	请求唯一id
data.CoverImgSrc	string	PPT封面图链接
data.title	string	PPT主标题
data.subTitle	string	PPT副标题

#2 自定义PPT生成接口

2.1 接口描述：

基于用户提示、文档等相关内容生成PPT，字数不得超过8000字，文件限制10M。

2.2 接口地址：

https://zwapi.xfyun.cn/api/aippt/createByDoc

2.3 请求查询参数：

POST，multipart/form-data

名称	类型	描述	必须	默认值
query	String	用户生成PPT要求（最多8000字）	N
file	MultipartFile	上传文件	N
file_url	String	文件连接	N	file和file_url必须二选一
file_name	String	文件名	Y	带文件名后缀
theme	String	PPT生成主题：随机主题(默认)、紫影幽蓝……	N	auto
business_id	String	业务ID（非必传）- 业务方自行决定是否使用	N
author	String	PPT作者名：用户自行选择是否设置作者名	N	智文
is_card_note	Bool	是否生成PPT演讲备注	N	false
is_cover_img	Boolean	是否生成封面图	N	false
language	String	语种	N	cn
is_figure	Bool	是否自动配图	N	false

2.5 请求响应：

{
    "code":0,
    "desc":"成功",
    "data":{
    "sid":"zhiwen@xxxxxxxxxxxxxxxxxxxxx",// 请求唯一ID
        "coverImgSrc":"xxxxxxxxxxxxxx",// 封面地址
        "title" : "xxx",// 主标题
        "subTitle" : "xxx"// 副标题
    }
}

2.6 响应描述

响应字段	类型	描述
code	int	错误码
desc	string	错误详情
data.sid	string	请求唯一id
data.CoverImgSrc	string	PPT封面图链接
data.title	string	PPT主标题
data.subTitle	string	PPT副标题

#3 大纲生成

3.1 接口地址：

https://zwapi.xfyun.cn/api/aippt/createOutline

3.2 请求参数查询

POST，application/json

名称	类型	描述	必须	默认值
query	String	用户生成PPT要求（最多8000字）	Y
create_model	String	PPT生成类型：文本生成、话题生成、程序判断(默认)	N	auto
theme	String	PPT生成主题：随机主题(默认)、紫影幽蓝……	N	auto
business_id	String	业务ID（非必传）- 业务方自行决定是否使用	N
author	String	PPT作者名：用户自行选择是否设置作者名	N	智文
is_card_note	Bool	是否生成PPT演讲备注	N	false
is_cover_img	Bool	是否生成封面图	N	false
language	String	语种	N	cn
is_figure	Bool	是否自动配图	N	false

3.3 请求响应

{
    "flag": true,
    "code": 0,
    "desc": "成功",
    "count": null,
    "data": {
        "sid": "本次请求sid",
        "coverImgSrc": "xxx(封面图下载链接)",
        "title": "主标题",
        "subTitle": "副标题",
        "outline": {
            "id": 68133,
            "title": "主标题",
            "subTitle": "副标题",
            "fileUrl": "",
            "fileType": 0,
            "chapters": [
                {
                    "id": 68189,
                    "chapterTitle": "第一章 xxx",
                    "fileUrl": "",
                    "fileType": 0,
                    "chartFlag": false,
                    "searchFlag": false,
                    "chapterContents": [
                        {
                            "id": 68221,
                            "chapterTitle": "1.1 xxx",
                            "fileUrl": "",
                            "fileType": 0,
                            "chartFlag": false,
                            "searchFlag": false,
                            "chapterContents": null
                        },
                        {
                            "id": 68223,
                            "chapterTitle": "1.2 xxx",
                            "fileUrl": "",
                            "fileType": 0,
                            "chartFlag": false,
                            "searchFlag": false,
                            "chapterContents": null
                        }
                    ]
                },
                {
                    "id": 68179,
                    "chapterTitle": "第二章 xxx",
                    "fileUrl": "",
                    "fileType": 0,
                    "chartFlag": false,
                    "searchFlag": false,
                    "chapterContents": [
                        {
                            "id": 68245,
                            "chapterTitle": "2.1 xxx",
                            "fileUrl": "",
                            "fileType": 0,
                            "chartFlag": false,
                            "searchFlag": false,
                            "chapterContents": null
                        },
                        {
                            "id": 68247,
                            "chapterTitle": "2.2 xxx",
                            "fileUrl": "",
                            "fileType": 0,
                            "chartFlag": false,
                            "searchFlag": false,
                            "chapterContents": null
                        }
                    ]
                }
            ],
            "end": "",
            "fileId": null
        }
    }
}

3.4 响应描述

响应字段	类型	描述
code	int	错误码
desc	string	错误详情
data.sid	string	请求唯一id
data.CoverImgSrc	string	PPT封面图链接
data.title	string	PPT主标题
data.subTitle	string	PPT副标题
outline.title	string	PPT主标题
outline.subTitle	string	PPT副标题
outline.chapters.chapterTitle	String	章节标题
outline.end	String	结尾

3.5 大纲结构体说明

public class OutlineVo {

    // 大纲ID
    private Long id;

    // 主标题
    private String title;

    // 副标题
    private String subTitle;
    
    // 二级标题
    private List<Chapter> chapters;

    // 参考文件相关，暂未开放能力
    private String fileUrl = "";
    Integer fileType = 0;
    private String end = "";
    private String fileId;

    public static class Chapter {
        // 大纲ID，若为新增大纲则设为NULL
        Long id;
        // 章节、子章节标题名称
        String chapterTitle;
        
        // 参考文件相关，能力暂未开放
        String fileUrl = "";
        Integer fileType = 0;
        Boolean chartFlag = false;
        Boolean searchFlag = false;
        List<Chapter> chapterContents = null;
    }
}

#4 自定义大纲生成

4.1 接口描述：

基于用户提示、文档等相关内容生成PPT大纲，字数不得超过8000字，文件限制10M。

4.2 接口地址：

https://zwapi.xfyun.cn/api/aippt/createOutlineByDoc

4.3 请求查询参数：

POST，multipart/form-data

名称	类型	描述	必须	默认值
query	String	用户生成PPT要求（最多8000字）	N
file	MultipartFile	上传文件	N
file_url	String	文件连接	N	file和file_url必须二选一
file_name	String	文件名	Y	带后缀
theme	String	PPT生成主题：随机主题(默认)、紫影幽蓝……	N	auto
business_id	String	业务ID（非必传）- 业务方自行决定是否使用	N
author	String	PPT作者名：用户自行选择是否设置作者名	N	智文
is_card_note	Bool	是否生成PPT演讲备注	N	false
is_cover_img	Bool	是否生成封面图	N	false
language	String	语种	N	cn
is_figure	Bool	是否自动配图	N	false

#5 通过sid和修改后大纲生成PPT

5.1 接口地址：

https://zwapi.xfyun.cn/api/aippt/createBySid

5.2 请求查询参数：

POST，application/json

名称	类型	描述	必须	默认值
sid	String	已生成大纲后，相应返回的请求唯一id	Y
outline	String	修改后大纲（若本次不传，则根据sid获得第一次生成的大纲内容进行ppt生成）	N	首次生成的大纲

5.3 请求响应与说明

见1.5、1.6小节说明

#6 通过大纲生成PPT

6.1 接口地址：

https://zwapi.xfyun.cn/api/aippt/createByOutline

6.2 请求查询参数：

POST，application/json

名称	类型	描述	必须	默认值
query	String	用户生成PPT要求（最多8000字）	Y
outline	String	大纲内容（不得超过10个一级大纲）	Y
create_model	String	PPT生成类型：文本生成、话题生成、程序判断(默认)	N	auto
theme	String	PPT生成主题：随机主题(默认)、紫影幽蓝……	N	auto
business_id	String	业务ID（非必传）- 业务方自行决定是否使用	N
author	String	PPT作者名：用户自行选择是否设置作者名	N	智文
is_card_note	Bool	是否生成PPT演讲备注	N	false
is_cover_img	Bool	是否生成封面图	N	false
language	String	语种（保证传入大纲语种与输入PPT语种一致）	N	cn
is_figure	Bool	是否自动配图	N	false

6.3 请求响应与说明

见1.5、1.6小节说明

#7 PPT进度查询

7.1 接口地址：

https://zwapi.xfyun.cn/api/aippt/progress?sid={}

7.2 请求查询参数：

注：该接口设置限流，三秒访问一次

GET

名称	类型	描述	必须
sid	String	请求唯一ID	Y

{
    "code":0,
    "desc":"成功",
    "data":{
    "process" : 0// 生成进度：30-大纲生成完毕、70-PPT生成完毕、100-PPT导出完毕
    "pptId" : xxxx// pptId
    "pptUrl" : xxxx// ppt下载链接
    "errMsg" : xxxx// 错误信息
    }
}

#8 PPT主题列表查询

8.1 接口地址：

https://zwapi.xfyun.cn/api/aippt/themeList

8.2 请求查询参数：

GET

{
    "flag": true,
    "code": 0,
    "desc": "成功",
    "count": null,
    "data": [
        {
            "key": purple,// 主题名
            "name": "紫影幽蓝",
            "thumbnail": "xxx",// 缩略图
        }
    ]
}

#9 扣量说明

基于query直接生成ppt：扣除10点量，1个并发，若需要增加备注，则增加5点量
基于query生成大纲：扣除2点量1个并发
基于sid，获取大纲（可修改）生成ppt：扣除8点量1个并发，若在表中记录该sid生成的ppt需要生成备注，额外扣除5点量
基于大纲生成ppt：8点量，若需要生成备注：额外扣除5点量
PPT自动配图：4点量
PPT多语种翻译：3点量，若仅生成大纲，则扣1点量

原文地址：https://blog.csdn.net/moshowgame/article/details/142320617

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：多层感知机paddle
下一篇：【ppt2svg svg2png/jpg】ppt转图片解决方案

Vue使用代理方式解决跨域问题
如果 Vue 前端应用请求后端 API 服务器，出现跨域问题（CORS），这个问题可以通过 vue.config.js 中的 devServer.proxy 选项来配置。通过使用代理方式解决跨域问题。
阅读更多2024-09-21
[网络层]-IP协议相关特性
不同的子网就是把网络号相同的主机放在一起, 如果在子网中新增一台主机, 则这台主机的网络号和这个子网的网络号一致,但是主机号不能和其他主机的主机号重复,通过合理的设置主机号和网络号,就可以保证在相互连
阅读更多2024-09-21
MySQL篇（存储引擎 - InnoDB存储引擎架构）（持续更新迭代）
MySQL5.5 版本开始，默认使用InnoDB存储引擎，它擅长事务处理，具有崩溃恢复特性，在日常开发中使用非常广泛。下面是InnoDB架构图，左侧为内存结构，右侧为磁盘结构。
阅读更多2024-09-21
ElasticSearch-2-核心语法集群高可用实战-Week2
这里多个文档是指，批量操作多个文档，搜索查询文档将在之后的章节讲解批量获取文档数据是通过_mget的API来实现的。
阅读更多2024-09-21
C#自定义曲线绘图面板
1、显示面板绘制。2、拖动面板，X轴、Y轴都可以拖动。3、显示面板缩放，放大或者缩小。4、鼠标在面板中对应的XY轴数值。5、自动生成的数据数组，曲线显示。6、鼠标是否在曲线上检测。
阅读更多2024-09-21
Web开发之Thymeleaf引擎
模板引擎就是一种用于将动态数据与HTML模板结合，生成最终用户界面的工具，它可以帮助开发者以可维护和结构化的方式创建动态Web页面，模板引擎通常支持数据的动态插入、条件渲染、循环等功能Thymele
阅读更多2024-09-21
【C++】探秘二叉搜索树
二叉搜索树的底层实现
阅读更多2024-09-21
【Linux基础IO】深入Linux文件描述符与重定向：解锁高效IO操作的秘密
在Linux操作系统的广阔世界中，文件描述符（File Descriptor，简称fd）和重定向是理解并高效利用Linux IO（输入/输出）机制的关键基石。它们不仅是系统编程中不可或缺的概念，也是日
阅读更多2024-09-21
Css_动态渐变圆圈旋转效果
【代码】Css_渐变圆圈动态旋转效果。
阅读更多2024-09-21
其他比较条件
NULL条件，包括IS NULL条件和IS NOT NULL条件。空值的意思是难以获得的、未指定的、未知的或者不适用的。示例：查询employees表，找出薪水是5000,6000,8000的雇员ID
阅读更多2024-09-21