Repolode
pig-mesh

pig-mesh/deepseek4j

面向 DeepSeek API 的 Java SDK,支持对话、函数调用、结构化输出,并提供 Spring Boot Starter。

Star
750
Fork
142
未关闭 Issue
16
最近提交
13天前

这是什么?

deepseek4j 是调用 DeepSeek API 的 Java SDK,支持返回思维链的对话推理、函数调用、JSON 结构化输出,以及基于 OpenAI 兼容协议的嵌入向量生成。默认模型为 DeepSeek Flash,也可通过配置或单次请求切换到 DeepSeek V4 Pro。

针对 Spring Boot 2.x 和 3.x 项目,Starter 模块会根据 application.yml 或 application.properties 自动装配客户端,流式响应以 Reactor Flux 形式返回,便于直接用于 SSE 接口。不使用 Spring 时,也可以依赖核心模块,通过 DeepSeekClient.builder() 创建客户端。项目同时支持 Solon 框架。

此外,SDK 封装了 DeepSeek 官方 Search API,可获取结构化网页搜索结果,并提供先搜索、再基于结果流式生成回答的组合调用。

核心功能

  • 01支持返回思维链的对话推理及会话账单数据
  • 02支持函数调用与 JSON 结构化输出
  • 03通过 OpenAI 兼容 API 生成嵌入向量
  • 04提供 Spring Boot Starter,自动装配客户端并支持流式响应
  • 05封装 DeepSeek 官方 Search API,支持同步与异步调用
  • 06可配置代理、超时及请求响应日志

适用场景

  • 在 Spring Boot 后端中接入 DeepSeek 对话功能
  • 通过 SSE 将模型回答流式推送到浏览器
  • 在不使用 Spring 的 Java 应用中直接调用 DeepSeek
  • 基于官方网页搜索结果生成有依据的回答

快速上手

  1. 1

    添加 Maven 依赖(Spring Boot 使用 starter,不使用 Spring Boot 则使用 deepseek4j-core)

  2. 2

    在 application.yml 的 deepseek.api-key 中配置你的 DeepSeek API Key

  3. 3

    注入 DeepSeekClient 并调用 chatFluxCompletion(prompt) 获取流式回复

使用前须知

  • 需要 DeepSeek API Key 才能调用服务。
  • 详细文档主要为中文。
  • 1.6.0 包含搜索相关的破坏性 API 变更,从 1.5.0 升级需要修改代码。

标签

常见问题

deepseek4j 是什么?
面向 DeepSeek API 的 Java SDK,支持对话、函数调用、结构化输出,并提供 Spring Boot Starter。 deepseek4j 是调用 DeepSeek API 的 Java SDK,支持返回思维链的对话推理、函数调用、JSON 结构化输出,以及基于 OpenAI 兼容协议的嵌入向量生成。默认模型为 DeepSeek Flash,也可通过配置或单次请求切换到 DeepSeek V4 Pro。
deepseek4j 可以免费使用吗?用的什么许可证?
deepseek4j 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
deepseek4j 还在维护吗?
活跃维护中。deepseek4j 最近一次提交是在 2026年10月25日。
deepseek4j 适合用来做什么?
在 Spring Boot 后端中接入 DeepSeek 对话功能 通过 SSE 将模型回答流式推送到浏览器 在不使用 Spring 的 Java 应用中直接调用 DeepSeek 基于官方网页搜索结果生成有依据的回答
deepseek4j 怎么安装和运行?
添加 Maven 依赖(Spring Boot 使用 starter,不使用 Spring Boot 则使用 deepseek4j-core) 在 application.yml 的 deepseek.api-key 中配置你的 DeepSeek API Key 注入 DeepSeekClient 并调用 chatFluxCompletion(prompt) 获取流式回复
在哪里获取 deepseek4j?
源代码和安装说明在 GitHub 上:https://github.com/pig-mesh/deepseek4j

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目