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

前言

在上一篇文章中，我们亲手用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”。它为我们做了这些事：

1. 封装复杂性：将底层的HTTP请求、认证、错误处理等细节全部封装起来，我们无需关心。
2. 提供类型安全：告别容易出错的Map<String, Object>。SDK提供了像ChatMessage, ChatCompletionRequest这样的专用Java类。这意味着你的IDE可以提供代码自动补全，并在编译时就帮你发现错误。
3. 代码更简洁、可读性更高：通过流畅的建造者模式（Builder Pattern），我们可以用非常自然的方式来构建请求。
4. 易于维护和扩展：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程序的基本结构。]

四、对比：天壤之别

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

差异一目了然。SDK让我们从“装配工”变成了“指挥家”。

总结

今天，我们成功地迈出了一大步，并且修正了一个重要的技术细节。我们不仅学会了使用SDK来极大地简化AI应用开发，更重要的是，我们掌握了如何正确地配置SDK以适配兼容的API服务。

掌握了这一技巧，意味着任何提供与OpenAI兼容API的大模型服务，你都可以用同样的方式快速接入。

现在，我们已经有了一个简洁、高效的工具来与AI交互。但目前它还只是一个运行在main方法里的简单脚本。如何将这种能力真正地融入到我们日常开发的企业级应用中呢？

答案就是我们最熟悉的伙伴——Spring Boot。

下一篇预告：
《Java大模型开发入门 (4/15)：融入企业级开发 - 将大模型能力集成到Spring Boot应用》—— 我们将创建一个Spring Boot项目，把AI服务封装成一个Bean，并通过一个RESTful API接口，让你的第一个AI应用跑起来！