ChatGpt基于第三方API2D服务封装的SpringBoot starter

前置条件:
看下API2D官网,第三方API2D服务对接流程:
其对接文档地址
https://api2d.com/wiki/doc

一:创建一个空的Maven项目
完成后整的项目层级图如下
在这里插入图片描述

1.pom.xml 中添加相关依赖包

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><artifactId>jinyi-chatgpt-api2d-starter</artifactId><properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target><jinyi-up.version>1.0.0</jinyi-up.version><lombok.version>1.18.22</lombok.version><commons-lang3.version>3.12.0</commons-lang3.version><fastjson.version>2.0.22</fastjson.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-configuration-processor</artifactId><!--不设置optional或者optional是false,表示传递依赖.  此处表示两个项目之间依赖不传递--><optional>true</optional><version>2.6.11</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombok.version}</version></dependency><dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>${hutool-all.version}</version></dependency><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>${commons-lang3.version}</version></dependency><dependency><groupId>com.alibaba.fastjson2</groupId><artifactId>fastjson2</artifactId><version>${fastjson.version}</version></dependency></dependencies></project>

2.项目中涉及到的类

package com.jinyi.up.chatgpt.api2d.config;import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
@Data
@Component
@ConfigurationProperties(prefix = "dbj.chatgpt.api2d")
public class ChatGptApi2dConfig {private String host;private String forwardKey;
}
package com.jinyi.up.chatgpt.api2d.constants;
import lombok.Getter;
/*** api2d常量** @author zhiquan*/
@Getter
public class Api2dConstant {/*** 正式接口,分布式部署*/public static final String API2D_HOST_OFFICIAL = "https://openai.api2d.net";/*** 备用接口,如果上一个无法使用(比如因为域名包含 openai 被屏蔽)可以使用这个*/public static final String API2D_HOST_STANDBY = "https://oa.api2d.net";/*** 临时域名,如果前两个都无法访问可以尝试这两个(过期时间 2024-06-15)*/public static final String API2D_HOST_TEMPORARY_1 = "https://oa.api2d.site";public static final String API2D_HOST_TEMPORARY_2 = "https://oa.api2d.online";/*** 备用接口,如果前两个都无法使用,可以使用这个*/public static final String API2D_HOST_BACKUP_1 = "https://stream.api2d.net";/*** 请求拼接模板*/public static final String reqUrlTemplate = "%s%s";/*** OpenAI 聊天接口( /v1/chat/completions )*/public static final String CHAT_COMPLETIONS_URL = "/v1/chat/completions";/*** OpenAI 内容补全接口( /v1/completions )*/public static final String COMPLETIONS_URL = "/v1/completions";/*** OpenAI 文本编辑接口( /v1/edits )*/public static final String EDITS_URL = "/v1/edits";/*** OpenAI 向量生成接口( /v1/embeddings )*/public static final String EMBEDDINGS_URL = "/v1/embeddings";/*** OpenAI 图片生成接口( /v1/images/generations )*/public static final String IMAGES_GENERATIONS_URL = "/v1/images/generations";
}
package com.jinyi.up.chatgpt.api2d.enums;import lombok.AllArgsConstructor;
import lombok.Getter;/*** @author  zhiquan*/
@AllArgsConstructor
@Getter
public enum Api2dModelTypeEnum {GPT_4(1, "gpt-4"),GPT_4_0314(2, "gpt-4-0314"),GPT_3_5_TURBO_0301(3, "gpt-3.5-turbo-0301"),GPT_3_5_TURBO(4, "gpt-3.5-turbo");private Integer status;private String describe;public static Api2dModelTypeEnum match(Integer status, Api2dModelTypeEnum defaultEnum) {if (status != null) {for (Api2dModelTypeEnum item : Api2dModelTypeEnum.values()) {if (item.status.equals(status)) {return item;}}}return defaultEnum;}public static String getDescirbe(Integer status, String defaultStr) {if (status != null) {for (Api2dModelTypeEnum item : Api2dModelTypeEnum.values()) {if (item.status.equals(status)) {return item.getDescribe();}}}return defaultStr;}
}
package com.jinyi.up.chatgpt.api2d.entitys;import lombok.Data;
import lombok.experimental.Accessors;import java.util.List;/*** chat 调用 聊天接口( /v1/chat/completions )需要封装的请求对象*  @author zhiquan*/
@Data
@Accessors(chain = true)
public class Api2dParamData {private String model;private List<Api2dParamSonData> messages;
}
package com.jinyi.up.chatgpt.api2d.entitys;import lombok.Data;
import lombok.experimental.Accessors;/*** chat 调用 聊天接口( /v1/chat/completions )需要封装的请求对象Api2dParamData的子对象* @author zhiquan*/
@Data
@Accessors(chain = true)
public class Api2dParamSonData {private String role = "user";private String content;
}
package com.jinyi.up.chatgpt.api2d.entitys;import lombok.Data;import java.util.List;/*** chat 调用 聊天接口( /v1/chat/completions )后返回的json*字段完全同步于第三方响应字段* @author zhiquan*/
@Data
public class ChatCompletionsResponse {/*** 对话标识符,用于唯一标识此次聊天会话*/private String id;/*** 对象类型,表示此响应是一个聊天完成事件*/private String object;/*** 响应创建时间的时间戳*/private int created;/*** 使用的模型名称,此处为“gpt-3.5-turbo-0301"*/private String model;/*** 包含模型生成的选择回答的列表,这里只有一个选项*/private List<Choices> choices;/*** API 的使用情况统计信息*/private Usage usage;
}
package com.jinyi.up.chatgpt.api2d.entitys;import com.alibaba.fastjson2.annotation.JSONField;
import lombok.Data;/*** chat 调用 聊天接口( /v1/chat/completions )后返回的json对象的子属性* 字段完全同步于第三方响应字段** @author zhiquan*/
@Data
public class Choices {/*** 回答的索引号。*/private int index;/*** 表示模型生成的回答*/private Message message;/*** 完成原因,这里是“stop",表示模型停止生成回答*/@JSONField(name = "finish_reason")private String finishReason;
}
package com.jinyi.up.chatgpt.api2d.entitys;import lombok.Data;/*** chat 调用 聊天接口( /v1/chat/completions )后返回的json对象的子属性*字段完全同步于第三方响应字段* @author zhiquan*/
@Data
public class Message {/*** 角色,这里是“assistant",表示助手角色生成的回答*/private String role;/*** 回答的内容*/private String content;
}
package com.jinyi.up.chatgpt.api2d.entitys;import com.alibaba.fastjson2.annotation.JSONField;
import lombok.Data;/*** chat 调用 聊天接口( /v1/chat/completions )后返回的json对象的子属性* 字段完全同步于第三方响应字段** @author zhiquan*/
@Data
public class Usage {/*** 用于 prompt 的令牌数量*/@JSONField(name="prompt_tokens")private int promptTokens;/*** 生成的回复的令牌数量*/@JSONField(name="completion_tokens")private int completionTokens;/*** 请求的总令牌数量 (包括输入和输出)*/@JSONField(name="total_tokens")private int totalTokens;/*** 截至此次请求时的令牌数*/@JSONField(name="pre_token_count")private int preTokenCount;/*** 初始限制的令牌数。*/@JSONField(name="pre_total")private int preTotal;/*** 根据模型的内部限制调整后的令牌数*/@JSONField(name="adjust_total")private int adjustTotal;/*** 最终用于此次请求的令牌数。*/@JSONField(name="final_total")private int finalTotal;
}
package com.jinyi.up.chatgpt.api2d.utils;import cn.hutool.http.HttpRequest;
import cn.hutool.json.JSONUtil;
import com.google.common.collect.Lists;
import com.jinyi.up.chatgpt.api2d.config.ChatGptApi2dConfig;
import com.jinyi.up.chatgpt.api2d.constants.Api2dConstant;
import com.jinyi.up.chatgpt.api2d.entitys.Api2dParamData;
import com.jinyi.up.chatgpt.api2d.entitys.Api2dParamSonData;
import com.jinyi.up.chatgpt.api2d.entitys.ChatCompletionsResponse;
import com.jinyi.up.chatgpt.api2d.enums.Api2dModelTypeEnum;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Component;import javax.annotation.Resource;
import java.util.List;/*** api2d 请求util*/
@Slf4j
@Component
public class ChartGptApi2dUtil {@Resourceprivate ChatGptApi2dConfig chatGptApi2dConfig;/*** 调用POST请求类型(application/json)接口** @param* @return*/private String publicApi2dInterface(String jsonStr, String url) throws Exception {String authTemp = "Bearer %s";String HttpResponseBodyStr = HttpRequest.post(url).header("Content-Type", "application/json").header("Authorization", String.format(authTemp, chatGptApi2dConfig.getForwardKey())).body(jsonStr).timeout(60000).execute().body();return HttpResponseBodyStr;}/*** ChartGPT聊天 返回响应的转换后的对象** @param reqContent 输入的提问内容* @param modelType  chatgpt版本type{@link com.jinyi.up.chatgpt.api2d.enums.Api2dModelTypeEnum}* @return ChatCompletionsResponse*/public ChatCompletionsResponse chatCompletionsEntity(Integer modelType, String reqContent) throws Exception {String resultJsonStr = chatCompletionsString(modelType, reqContent);log.info(resultJsonStr);if (!StringUtils.isBlank(resultJsonStr)) {ChatCompletionsResponse bean = JSONUtil.toBean(resultJsonStr, ChatCompletionsResponse.class);return bean;}return null;}/*** ChartGPT聊天返回原生响应的JSON STRING** @param reqContent 输入的提问内容* @param modelType  chatgpt版本type{@link com.jinyi.up.chatgpt.api2d.enums.Api2dModelTypeEnum}* @return*/public String chatCompletionsString(Integer modelType, String reqContent) throws Exception {Api2dParamSonData api2dParamSonData = new Api2dParamSonData().setContent(reqContent);List<Api2dParamSonData> messages = Lists.newArrayList(api2dParamSonData);Api2dParamData api2dParamData = new Api2dParamData().setModel(Api2dModelTypeEnum.getDescirbe(modelType, Api2dModelTypeEnum.GPT_3_5_TURBO.getDescribe())).setMessages(messages);String url = String.format(Api2dConstant.reqUrlTemplate, chatGptApi2dConfig.getHost(), Api2dConstant.CHAT_COMPLETIONS_URL);log.info("ChartGPT聊天 请求url:{},请求param:{}", url, api2dParamData);return publicApi2dInterface(JSONUtil.toJsonStr(api2dParamData), url);}
}

3.resources文件夹下添加META-INF/spring.factories文件

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\com.jinyi.up.chatgpt.api2d.utils.ChartGptApi2dUtil,\
com.jinyi.up.chatgpt.api2d.config.ChatGptApi2dConfig

4.使用说明

jinyi-chatgpt-api2d-starter

jinyi-chatgpt-api2d-starter

时间当前版本版本特性作者
2023.7.120.0.1-RELEASE1.初版仅提供chatGpt提问功能zhiquan

组件简介

  • 基于API2D的API封装的

1.Spring Boot 项目添加 Maven 依赖

  <dependency><groupId>com.jinyi.up</groupId><artifactId>jinyi-chatgpt-api2d-starter</artifactId><version>1.0.0</version></dependency>

2、在application.properties 或者 application.yml 等配置文件中增加如下配置

dbj.chatgpt.api2d.host=https://stream.api2d.net   #api2d对外提供的ChatGpt访问的Api Host
dbj.chatgpt.api2d.forwardKey=fk****************8  #api2d服务提供的Forward Key
dbj:chatgpt:api2d:host: https://stream.api2d.net  #api2d对外提供的api访问HostforwardKey: fk****************8 #api2d服务提供的Forward Key 

3、使用示例

@Slf4j
@RestController
@RequestMapping("/test")
public class StarterTestController {@Resourceprivate ChartGptApi2dUtil chartGptApi2dUtil;@GetMapping("/gptStarter")public R<Object> gptStarter() {try {ChatCompletionsResponse result = chartGptApi2dUtil.chatCompletionsEntity(4, "儿童节文案");return R.ok(result);} catch (Exception e) {log.error("gpt回话请求异常:", e);}return R.failed();}
}

4、ChartGptApi2dUtil能力

4.1 chatCompletionsEntity(Integer modelType, String reqContent)方法: OpenAI 聊天方法,返回封装的ChatCompletionsResponse对象

**4.2 chatCompletionsString(Integer modelType, String reqContent)**方法:OpenAI 聊天方法,返回的调用api2d openApi接口后返回的原生json字符串

chatCompletionsEntity() 和chatCompletionsString()请求参数相同,详见如下表格

参数字段类型是否必填描述备注
modelTypeInteger*api2d 对应的model版本枚举 ,1: GPT_4 4:gpt-3.5-turbo详见Api2dModelTypeEnum
reqContentString*向chatgpt提问的问题内容

ChatCompletionsResponse对象属性说明

{"id": "chatcmpl-7bgwmOfeGf14HkOrpMCJ4x9cvdArF", #对话标识符,用于唯一标识此次聊天会话"object": "chat.completion", #对象类型,表示此响应是一个聊天完成事件"created": 1689217580, #响应创建时间的时间戳"model": "gpt-3.5-turbo-0613",  #使用的模型名称,此处为gpt-3.5-turbo-0613"choices": [  #包含模型生成的选择回答的列表,这里只有一个选项{"index": 0, #回答的索引号。"message": {  #表示模型生成的回答"role": "assistant", #角色,这里是“assistant",表示助手角色生成的回答"content": "科比,全名科比·布莱恩特(Kobe Bryant),1978年8月23日出生于美国宾夕法尼亚州费城,2019年1月26日因直升机失事意外身亡,是一位美国职业篮球运动员。科比是NBA历史上最伟大的球员之一,被誉为“黑曼巴”,他在职业生涯期间效力于洛杉矶湖人队。\n\n科比在NBA生涯中获得了众多荣誉,包括5个NBA总冠军、2个NBA总决赛最有价值球员(MVP)、4个全明星赛最有价值球员(MVP),以及18次入选NBA全明星阵容等。他也是NBA历史得分榜上位列第4的球员,总得分超过了3万分。\n\n除了在NBA的成功之外,科比也是美国国家队的重要成员,并在2008年和2012年两届奥运会上帮助美国队夺得金牌。\n\n科比在场上以他的得分能力和个人进攻技巧著称,他是一位极具竞争力的球员,对胜利有着强烈的渴望。他的篮球智商和技术使他成为一个精准的得分手,同时他也是一位出色的防守球员。\n\n科比的突然离世使全球篮球界深感痛惜,他的篮球成就和影响力将永远铭记在人们心中。" #回答的内容},"finishReason": "stop"  #完成原因,这里是“stop",表示模型停止生成回答}],"usage": { #API 的使用情况统计信息"promptTokens": 9, #用于 prompt 的令牌数量"completionTokens": 463, #生成的回复的令牌数量"totalTokens": 472, # 请求的总令牌数量 (包括输入和输出)"preTokenCount": 4096, # 截至此次请求时的令牌数"preTotal": 42, #初始限制的令牌数。"adjustTotal": 37, #根据模型的内部限制调整后的令牌数"finalTotal": 5   #最终用于此次请求的令牌数。
}

原生Json字符串返回说明:

{"id":"chatcmpl-7bh9aayOMAY9z0iFDR5P4kdLNIjW1","object":"chat.completion","created":1689218374,"model":"gpt-3.5-turbo-0613","choices":[{"index":0,"message":{"role":"assistant","content":"科比(Kobe),全名科比·布莱恩特(Kobe Bryant),是一位美国职业篮球运动员,出生于1978年8月23日,于2020年1月26日因直升机事故不幸去世。科比在NBA的职业生涯中效力于洛杉矶湖人队,被认为是最伟大的篮球运动员之一。\n\n科比从高中时期就开始展现出与众不同的篮球天赋,在1996年的NBA选秀中以第13顺位被夏洛特黄蜂队选中,但很快被湖人队用于交换筹码,成为NBA历史上最年轻的球员之一。\n\n科比在湖人队的职业生涯中取得了众多成绩,包括5次NBA总冠军、2次NBA总决赛MVP、1次常规赛MVP等荣誉。他是湖人队历史上得分最高的球员,并在职业生涯中共获得了4次得分王的称号。\n\n除了职业联赛中的成功,科比还是美国国家队的成员,参加了多次国际比赛,其中包括2008年北京奥运会和2012年伦敦奥运会,帮助美国获得金牌。\n\n科比以其出色的得分能力、技术精湛的投篮和极高的竞争意识而闻名,他被誉为NBA历史上最全能的得分手之一。科比对比赛有着非常高的热情和敬业精神,他的工作态度和专注度也给球迷们留下了深刻的印象。\n\n科比的突然离世给整个篮球界和广大球迷带来了巨大的震惊和悲伤。他将永远被人们铭记为一位伟大的篮球运动员,为他在篮球领域的贡献和对于比赛的热爱致以敬意与怀念。"},"finish_reason":"stop"}],"usage":{"prompt_tokens":9,"completion_tokens":619,"total_tokens":628,"pre_token_count":4096,"pre_total":42,"adjust_total":35,"final_total":7}}

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/21156.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【Python详解】Python类的详细定义与使用案例

大家好&#xff0c;我是洲洲&#xff0c;欢迎关注&#xff0c;一个爱听周杰伦的程序员。关注公众号【程序员洲洲】即可获得10G学习资料、面试笔记、大厂独家学习体系路线等…还可以加入技术交流群欢迎大家在CSDN后台私信我&#xff01; 本文目录 前言一、定义类二、类的实例化三…

对于 Spring MVC 了解? SpringMVC 的执行流程?SpringMVC 的核心是什么?请求的流程是怎么处理的?控制反转怎么实现的?

对于 Spring MVC 了解? 之前 Model1 和 Model2 这两个没有 Spring MVC 的时代。 Model1 时代 : 整个 Web 应用几乎全部用 JSP 页面组成&#xff0c;只用少量的 JavaBean 来处理数据库连接、访问等操作。 JSP 既是控制层又是表现层&#xff0c;存在很多问题&#xff0c;如①将…

阿里云ECS扩容硬盘空间及文件系统

一.通过阿里云控制台扩容硬盘 前往ECS实例详情页面的云盘页签。 登录ECS管理控制台。在左侧导航栏&#xff0c;选择实例与镜像 > 实例。在顶部菜单栏处&#xff0c;选择目标ECS实例所在地域。找到待扩容云盘所在的实例&#xff0c;单击实例ID。在实例详情页面&#xff0c;单…

android studio 添加并读取json配置文件

第一步&#xff1a;在android studio中添加json文件&#xff1b; 第二步&#xff1a;读取文件的函数 private String[] getJosnData(){String result[] null;List<String> list new ArrayList<>();try {//获取本地的Json文件AssetManager assetManager mConte…

解析Java类加载的运行机制和双亲委派模型

类加载运行机制 类加载形如把.class文件&#xff0c;加载到内存中&#xff0c;得到类对象这样的过程 类加载一共分为五个步骤&#xff1a; 加载验证准备解析初始化 加载 类加载的第一步是将编译好的 Java 类的字节码文件加载到 Java 虚拟机&#xff08;JVM&#xff09;中。类…

阿里云:机器学习平台及OpenSearch

机器学习流程 相关项目 BladeDISC-AI编译优化 EasyRec-推荐算法库 EasyCV-视觉图像算法库 EasyNLP-NLP/多模态算法库 模型开发中算法团队面临的工程挑战 Develop platform OpenSearch 向量检索库

1.4 MVP矩阵

MVP矩阵代表什么 MVP矩阵分别是模型&#xff08;Model&#xff09;、观察&#xff08;View&#xff09;、投影&#xff08;Projection&#xff09;三个矩阵。 我们的顶点坐标起始于局部空间&#xff08;Local Space&#xff09;&#xff0c;在这里他成为局部坐标&#xff08;L…

【大语言模型】LLM应用程序的新兴体系结构

LLM应用程序的新兴体系结构 LLM应用栈设计模式&#xff1a;In-context learningData Preprocessing/EmbeddingPrompt Construction/RetrievalPrompt Execution/Inference What about agents?展望参考资料 大型语言模型是构建软件的强大新基元。但由于它们非常新颖且与常规计算…

J2EE集合框架Map

目录 一.Map特点 1.无序&#xff0c;键值对&#xff0c;键不能重复&#xff0c;值可以重复 2.键重复则覆盖&#xff0c;没有继承Collection接口 二.遍历方式 1.拿到key,再拿值2.拿到映射关系&#xff0c;键值都有 取出保存所有Entry的Set,再遍历此Set即可 三.HashMap与H…

【数据结构】树与二叉树(上)

目录 前言&#xff1a; 一、树&#xff1a; 1.树的概念&#xff1a; 2.树的相关概念&#xff1a; 3.树的表示&#xff1a; 4.书的实际使用场景&#xff1a; 二、二叉树&#xff1a; 1.二叉树的概念&#xff1a; 2.两种特殊二叉树&#xff1a; ①.满二叉树&#xff1a;…

C++图形开发(16):绘制一个圆环和一根针

文章目录 绘制一个圆环和一根针1.1 绘制1.2 line()函数1.3 circle()函数1.4 setlinestyle()函数1.5 setlinecolor()函数 接下来&#xff0c;我会继续制作一些小游戏&#xff0c;但因为整个难度的上升&#xff08;毕竟我也是初学者&#xff09;&#xff0c;可能文章不会再像之前…

Can转RTU网关can总线转以太网设备

YC-CAN-RTU 是一款用于 CAN-Modbus 现场总线与 RS-232 总线或 RS-485 总线之间数据转换的协议型转换器&#xff0c;支持标准 Modbus RTU 协议。集成 1 路RS-232 通道、1 路RS-485 通道、1 路CAN-Modbus 通道&#xff0c;可以方便地嵌入使用 RS-232 接口和 RS-485 接口的节点上&…