当前位置：首页 > news >正文

Java大模型开发入门 (3/15): 拥抱官方标准 - 使用OpenAI官方Java SDK调用DeepSeek

news 2025/6/13 20:08:25

前言

在上一篇文章中，我们亲手用HttpClient实现了对DeepSeek API的调用。这个过程虽然让我们理解了底层的HTTP交互，但你肯定也感受到了其中的繁琐和不便：手动拼装JSON、处理请求头、解析响应……每一步都像是在用石器造车。

是时候“升级装备”了！今天，我们将学习如何使用一个专门为此设计的工具——软件开发工具包（SDK），来让我们的代码变得更优雅、更健壮。

更妙的是，我们将利用DeepSeek API与OpenAI API的兼容性，直接使用OpenAI官方提供的Java SDK来调用DeepSeek。这不仅能让我们见识到SDK的威力，还能体会到API标准化的巨大好处。

一、什么是SDK？为什么我们需要它？

如果你用过Spring Data JPA来操作数据库，你就已经体会过类似SDK的好处了。你不再需要手写JDBC连接、PreparedStatement和解析ResultSet，而是通过简单的接口调用（如userRepository.save(user)）来完成工作。

SDK（Software Development Kit）就是AI开发领域的“JPA”。它为我们做了这些事：

封装复杂性：将底层的HTTP请求、认证、错误处理等细节全部封装起来，我们无需关心。
提供类型安全：告别容易出错的Map<String, Object>。SDK提供了像ChatMessage, ChatCompletionRequest这样的专用Java类。这意味着你的IDE可以提供代码自动补全，并在编译时就帮你发现错误。
代码更简洁、可读性更高：通过流畅的建造者模式（Builder Pattern），我们可以用非常自然的方式来构建请求。
易于维护和扩展：SDK由官方或社区维护，能跟上API的更新。同时，实现流式输出（Streaming）等高级功能也变得异常简单。

一言以蔽之，SDK让我们能专注于业务逻辑，而不是底层的通信细节。

二、引入OpenAI Java SDK

首先，我们需要在我们的Maven项目中添加OpenAI Java SDK的依赖。请打开你的pom.xml文件，在<dependencies>标签中加入以下内容：

<dependency><groupId>com.openai</groupId><artifactId>openai-java-client</artifactId><version>1.7.0</version> 
</dependency>

如果你使用Gradle，配置如下：
implementation("com.openai:openai-java:2.7.0")'

保存文件后，Maven或Gradle会自动下载所需的jar包。

三、代码实战：用SDK重构我们的对话程序

现在，让我们用SDK来重写上一篇的SimpleChatWithDeepSeek。你会发现代码量骤减，可读性飙升。

1. 编写代码
创建一个新的Java类，例如OfficialSdkChat.java。

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;
import com.openai.models.chat.completions.ChatCompletionMessage;public class OfficialSdkChat {public static void main(String[] args) {// 1. 从环境变量获取API Key，这是一个好习惯String apiKey = "sk-xxxxx";if (apiKey == null || apiKey.isEmpty()) {System.err.println("错误：未设置DEEPSEEK_API_KEY环境变量。");return;}// 2. 手动构建客户端，清晰地指定Base URL和API Key// 这是连接到任何兼容OpenAI的第三方服务（如DeepSeek）的标准方式OpenAIClient client = OpenAIOkHttpClient.builder().baseUrl("https://api.deepseek.com/v1/").apiKey(apiKey).build();System.out.println("客户端创建成功，正在构建请求...");// 3. 构建请求参数，注意其流畅的API设计ChatCompletionCreateParams params = ChatCompletionCreateParams.builder().addUserMessage("你好，请用java写一个hello world") // 直接添加用户消息，超便捷！.model("deepseek-chat") // 指定模型名称.build();// 4. 发送请求并获取响应try {System.out.println("正在发送请求到 DeepSeek API...");ChatCompletion chatCompletion = client.chat().completions().create(params);// 5. 遍历并打印结果// 使用forEach和Lambda表达式，代码非常现代和简洁System.out.println("\nAI的回答:");chatCompletion.choices().forEach(choice -> {ChatCompletionMessage message = choice.message();System.out.println(message.content());});} catch (Exception e) {System.err.println("请求失败: " + e.getMessage());e.printStackTrace();} finally {// 6. 关闭客户端，释放资源client.close();}}
}

2. 验证结果
如果一切正常的话，结果应该是这个样子：

客户端创建成功，正在构建请求...
正在发送请求到 DeepSeek API...AI的回答:
Optional[以下是用Java编写的经典"Hello World"程序：public class HelloWorld {public static void main(String[] args) {System.out.println("Hello, World!");}
}代码说明：
1. `public class HelloWorld` 定义了一个公共类，类名必须与文件名一致（即保存为HelloWorld.java）
2. `public static void main(String[] args)` 是Java程序的入口点
3. `System.out.println()` 用于向控制台输出文本编译和运行步骤：
1. 将代码保存为HelloWorld.java
2. 打开终端/命令提示符，导航到文件所在目录
3. 编译：`javac HelloWorld.java`
4. 运行：`java HelloWorld`输出结果：Hello, World!这是Java最基础的程序，适合初学者理解Java程序的基本结构。]

四、对比：天壤之别

让我们直观地对比一下两种方式的核心代码：

特性	手动 `HttpClient` (上一篇)	使用 `OpenAI SDK` (本篇)
请求构建	手动创建`Map`，用`ObjectMapper`转为JSON字符串。容易出错。	`ChatCompletionCreateParams.builder()` `.model(...)` `.addUserMessage(...)` `.build()`
类型安全	全部是`Map<String, Object>`和`String`，没有编译时检查。	`ChatCompletionMessage`, `ChatCompletionCreateParams`等专用类，IDE支持，编译时检查。
调用	`client.send(request, ...)`，需要手动处理响应码和响应体。	`client.chat().completions().create(params)`，直接返回一个结构化的Java对象。
代码量	核心逻辑约20-30行。	核心逻辑约5-10行。
可读性	较低，充满了底层细节。	很高，接近自然语言描述。