星火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转图片解决方案

将整数的奇偶位互换
就拿整数9举例，它的二进制是1001。前半部分的10交换后变成01，后半部分的01交换后变成10。组合起来就得到了0110。将原数字的奇数位左移一位，将原数字的偶数位右移一位。再用异或运算组合在一起就
阅读更多2024-11-15
sql server 创建分区表
GOGOGO。
阅读更多2024-11-15
scala创建图书信息类，包含三个属性：书名，作者，价格
val book = new Book("《Scala编程从入门到精通》", "佚名", 59.9)// 可以在这里定义其他的方法，比如展示图书信息的方法等，以
阅读更多2024-11-15
WebSocket和HTTP协议的性能比较与选择
本文将重点讨论WebSocket和HTTP协议之间的性能比较，并提供一些具体的代码示例，以便开发者根据实际需求进行选择。根据实际需求选择合适的网络协议是很重要的，WebSocket和HTTP协议都有各
阅读更多2024-11-15
图论算法：最短路径算法详解【c语言版】(无权最短路径、Dijkstra算法）
！!
阅读更多2024-11-15
Flutter网络通信-封装Dio
dio 是一个强大的 Dart HTTP 请求库，支持全局配置、Restful API、FormData、拦截器、请求取消、Cookie 管理、文件上传/下载、超时以及自定义适配器等。code是请求
阅读更多2024-11-15
使用Java爬虫获取淘宝商品类目API返回值
在互联网时代，数据是无价的资源。对于电商平台来说，商品类目数据是构建推荐系统、市场分析和用户行为研究的基础。淘宝作为中国最大的电商平台，其商品类目API提供了丰富的数据接口。本文将介绍如何使用Java
阅读更多2024-11-15
Ceph client 写入osd 数据的两种方式librbd 和kernel rbd
librbd和kernel rbd是Ceph客户端写入OSD数据的两种主要方式。librbd提供了灵活的编程接口和高效的数据管理功能，适用于多种开发语言和场景；而kernel rbd则提供了与标准块设
阅读更多2024-11-15
SpringBoot（六）mybatis基本语法
（仅对 insert 和 update 有用）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Serv
阅读更多2024-11-15
i春秋-SQLi（无逗号sql注入，-- -注释）
i春秋-SQLi
阅读更多2024-11-15