DeepSeek4j Java SDK 技术文档

DeepSeek4j Java SDK 技术文档

【免费下载链接】deepseek4j deepseek4j 是面向 DeepSeek 推出的 Java 开发 SDK，支持 DeepSeek R1 和 V3 全系列模型。提供对话推理、函数调用、JSON结构化输出、以及基于 OpenAI 兼容 API 协议的嵌入向量生成能力。通过 Spring Boot Starter 模块，开发者可以快速为 Spring Boot 2.x/3.x 以及 Solon 等主流 Java Web 框架集成 AI 能力，提供开箱即用的配置体系、自动装配的客户端实例，以及便捷的流式响应支持。 项目地址: https://gitcode.com/pig-mesh/deepseek4j

1. 安装指南

1.1 系统要求

• Java 8 或更高版本
• Spring Boot 2.x/3.x 或 Solon 框架
• Maven 3.0+

1.2 依赖安装

在项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>io.github.pig-mesh.ai</groupId>
    <artifactId>deepseek-spring-boot-starter</artifactId>
    <version>1.4.7</version>
</dependency>

2. 项目使用说明

2.1 基础配置

在 application.yml 或 application.properties 中配置API密钥：

deepseek:
  api-key: your-api-key-here

2.2 核心功能使用

2.2.1 注入客户端

@Autowired
private DeepSeekClient deepSeekClient;

2.2.2 流式对话接口

@GetMapping(value = "/chat", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<ChatCompletionResponse> chat(String prompt) {
    return deepSeekClient.chatFluxCompletion(prompt);
}

2.2.3 前端调试

项目提供了SSE调试页面(sse.html)，可直接运行进行接口测试：

1. 双击打开sse.html文件
2. 输入后端SSE接口地址
3. 点击发送按钮实时查看推理结果

3. 项目API使用文档

3.1 核心API

3.1.1 同步对话接口

ChatCompletionResponse response = deepSeekClient.chatCompletion(prompt);

3.1.2 流式对话接口

Flux<ChatCompletionResponse> responseFlux = deepSeekClient.chatFluxCompletion(prompt);

3.1.3 函数调用

FunctionCallResponse response = deepSeekClient.functionCall(functionSpec, parameters);

3.1.4 JSON结构化输出

StructuredResponse response = deepSeekClient.structuredOutput(prompt, outputSchema);

3.2 高级配置

3.2.1 自定义连接参数

deepseek:
  connect-timeout: 5000
  read-timeout: 10000
  proxy:
    host: proxy.example.com
    port: 8080

3.2.2 请求日志

deepseek:
  logging:
    request: true
    response: true

4. 项目安装方式

4.1 Maven安装

如1.2节所示，在pom.xml中添加依赖后执行：

mvn clean install

4.2 手动安装

1. 下载项目JAR包
2. 添加到项目lib目录
3. 在构建路径中添加依赖

4.3 配置验证

启动应用后，可通过以下方式验证安装：

@SpringBootTest
public class DeepSeekTest {
    @Autowired
    private DeepSeekClient client;
    
    @Test
    public void testConnection() {
        assertNotNull(client);
    }
}

5. 注意事项

1. 确保API密钥有效且未过期
2. 流式接口需要使用SSE协议
3. 生产环境建议配置合理的超时参数
4. 函数调用需要预先定义好函数规范

【免费下载链接】deepseek4j deepseek4j 是面向 DeepSeek 推出的 Java 开发 SDK，支持 DeepSeek R1 和 V3 全系列模型。提供对话推理、函数调用、JSON结构化输出、以及基于 OpenAI 兼容 API 协议的嵌入向量生成能力。通过 Spring Boot Starter 模块，开发者可以快速为 Spring Boot 2.x/3.x 以及 Solon 等主流 Java Web 框架集成 AI 能力，提供开箱即用的配置体系、自动装配的客户端实例，以及便捷的流式响应支持。 项目地址: https://gitcode.com/pig-mesh/deepseek4j