国外企业画册设计网站,注册城乡规划师报考条件2023,域名注册的网站,恩施做网站公司DeepSeek4j Spring Boot Starter 快速入门
简介
DeepSeek4j 是一个专为 Spring Boot 设计的 AI 能力集成启动器#xff0c;可快速接入 DeepSeek 大模型服务。通过简洁的配置和易用的 API#xff0c;开发者可轻松实现对话交互功能。 环境要求
JDK 8Spring Boot 2.7Maven/Gr…
DeepSeek4j Spring Boot Starter 快速入门
简介
DeepSeek4j 是一个专为 Spring Boot 设计的 AI 能力集成启动器可快速接入 DeepSeek 大模型服务。通过简洁的配置和易用的 API开发者可轻松实现对话交互功能。 环境要求
JDK 8Spring Boot 2.7Maven/Gradle 安装依赖
Maven
dependencygroupIdio.github.pig-mesh.ai/groupIdartifactIddeepseek-spring-boot-starter/artifactIdversion1.3.2/version
/dependency基础配置
在 application.yml 中添加以下配置
deepseek:api-key: your-api-key-here # 必填从 DeepSeek 控制台获取base-url: https://api.deepseek.com # 可选默认官方地址log-requests: true # 记录请求日志log-responses: true # 记录响应日志connect-timeout: 10 # 连接超时秒read-timeout: 30 # 读取超时秒call-timeout: 60 # 完整调用超时秒# 代理配置可选proxy:host: proxy.example.comport: 8080# 日志级别可选NONE/BASIC/HEADERS/BODYlog-level: BASIC核心使用示例
1. 流式交互推荐
Autowired
private DeepSeekClient deepSeekClient;/*** 流式对话接口* param prompt 用户输入* return SSE 流式响应*/
GetMapping(value /chat, produces MediaType.TEXT_EVENT_STREAM_VALUE)
public FluxChatCompletionResponse streamChat(String prompt) {return deepSeekClient.chatFluxCompletion(prompt);
}2. 进阶配置多轮对话
GetMapping(value /chat/advanced, produces MediaType.TEXT_EVENT_STREAM_VALUE)
public FluxChatCompletionResponse advancedChat(String prompt) {ChatCompletionRequest request ChatCompletionRequest.builder().model(ChatCompletionModel.DEEPSEEK_REASONER) // 指定推理模型.addUserMessage(prompt) // 用户当前问题.addAssistantMessage(上轮对话结果) // 历史助手回复.addSystemMessage(你是一名AI助理) // 系统角色设定.maxTokens(1000) // 最大生成 token 数.temperature(0.7) // 生成多样性控制.tools(yourFunctionTools) // Function Calling 工具.responseFormat(ChatResponseFormat.JSON) // 结构化响应.build();return deepSeekClient.chatFluxCompletion(request);
}3. 同步调用不推荐
GetMapping(/sync/chat)
public ChatCompletionResponse syncChat(String prompt) {ChatCompletionRequest request ChatCompletionRequest.builder().model(deepSeekProperties.getModel()) // 从配置读取模型.addUserMessage(prompt).build();return deepSeekClient.chatCompletion(request).execute();
}注意事项 流式优先原则 推荐使用 chatFluxCompletion 实现流式响应避免同步阻塞导致客户端超时。 模型选择建议 DEEPSEEK_CHAT: 通用对话场景DEEPSEEK_REASONER: 复杂推理场景通过 model() 方法动态指定 安全合规 敏感数据建议启用 encrypted-mobile 等加密字段遵守 GDPR 等数据保护法规 性能调优 根据业务调整 maxTokens默认 2048合理设置超时时间特别是 R1 长文本模型 错误处理 监听 onErrorResume 处理流式异常同步调用需捕获 IOException 和 APIException 附录
完整配置项说明
配置项类型必填默认值说明api-keyString是-平台颁发的 API 密钥base-urlString否官方 API 地址自定义服务端点log-requestsBoolean否false是否记录完整请求日志connect-timeoutint否10连接超时时间秒proxy.hostString否-代理服务器地址
