DeepSeek 大模型对接

前置条件

• 已部署微语系统
• 已申请 DeepSeek API Key（申请地址：https://api-docs.deepseek.com/zh-cn/）

配置步骤

1. 获取 API Key

1. 访问 DeepSeek 开发者平台：https://api-docs.deepseek.com/zh-cn/
2. 注册并登录账号
3. 在控制台创建 API Key
4. 保存生成的 API Key

2. 管理后台配置

1. 登录微语管理后台

3. 模型配置选择

1. 进入 AI 模型配置页面
2. 选择 DeepSeek 作为默认模型
3. 保存配置

4. 获取聊天代码

1. 在管理后台找到"获取聊天代码"选项
2. 复制生成的代码
3. 将代码集成到你的网站中

效果展示

配置完成后，你可以在网站中看到如下效果：

推荐模型

DeepSeek 已发布 DeepSeek-V4 预览版。在微语中，建议新配置优先使用以下模型名：

模型	推荐方式	说明
deepseek-v4-flash	推荐默认使用	响应更快、成本更优，适合大多数在线客服场景
deepseek-v4-pro	复杂场景优先	更适合复杂推理、长任务链路和 Agent 工作流
deepseek-chat	仅兼容旧配置	将于 2026-07-24 停止使用
deepseek-reasoner	仅兼容旧配置	将于 2026-07-24 停止使用

根据 DeepSeek 官方说明，在当前过渡阶段：

• deepseek-chat 对应 deepseek-v4-flash 的非思考模式
• deepseek-reasoner 对应 deepseek-v4-flash 的思考模式

因此，无论是新建机器人，还是调整租户默认模型，都建议直接选择 deepseek-v4-flash 或 deepseek-v4-pro。

配置说明（可选）

Docker部署配置参数

# DeepSeek API 配置
SPRING_AI_DEEPSEEK_BASE_URL: https://api.deepseek.com  # DeepSeek API 基础地址
SPRING_AI_DEEPSEEK_API_KEY: 'sk-xxx'                   # 替换为你的 DeepSeek API Key
SPRING_AI_DEEPSEEK_CHAT_ENABLED: true                  # 启用 DeepSeek 对话功能

# 模型配置
SPRING_AI_DEEPSEEK_CHAT_OPTIONS_MODEL: deepseek-v4-flash   # 推荐值：deepseek-v4-flash 或 deepseek-v4-pro
SPRING_AI_DEEPSEEK_CHAT_OPTIONS_TEMPERATURE: 0.7       # 温度参数，控制输出的随机性，范围 0-1
SPRING_AI_DEEPSEEK_EMBEDDING_ENABLED: true            # 启用 DeepSeek 文本嵌入功能

源码部署配置参数

# DeepSeek API 配置
spring.ai.deepseek.base-url=https://api.deepseek.com   # DeepSeek API 基础地址
spring.ai.deepseek.api-key=sk-xxx                      # 替换为你的 DeepSeek API Key
spring.ai.deepseek.chat.enabled=true                   # 启用 DeepSeek 对话功能

# 模型配置
spring.ai.deepseek.chat.options.model=deepseek-v4-flash    # 推荐值：deepseek-v4-flash 或 deepseek-v4-pro
spring.ai.deepseek.chat.options.temperature=0.7        # 温度参数，控制输出的随机性，范围 0-1

迁移建议

如果你还在使用旧模型名，建议尽快完成迁移：

• deepseek-chat -> deepseek-v4-flash
• deepseek-reasoner -> deepseek-v4-pro 或 deepseek-v4-flash

迁移时无需修改 base-url，只需要调整模型名称。

配置说明

• 将配置文件中的 sk-xxx 替换为你获取的 API Key
• 根据实际需求调整 temperature 参数
• 如果不需要文本嵌入功能，可以将 SPRING_AI_DEEPSEEK_EMBEDDING_ENABLED 设置为 false

常见问题

1. API Key 无效

   • 检查 API Key 是否正确复制
   • 确认 API Key 是否已激活
   • 验证 API Key 的权限设置

2. 对话响应慢

   • 检查网络连接
   • 确认服务器配置是否满足要求
   • 可以适当调整 temperature 参数
   • 如果更关注响应速度，优先选择 deepseek-v4-flash

3. 文本嵌入功能异常

   • 确认 SPRING_AI_DEEPSEEK_EMBEDDING_ENABLED 设置为 true
   • 检查 API Key 是否支持文本嵌入功能

4. 仍在使用旧模型名

   • deepseek-chat 与 deepseek-reasoner 将于 2026-07-24 停止使用
   • 建议尽快迁移到 deepseek-v4-flash 或 deepseek-v4-pro

相关资源

• DeepSeek API 文档
• Spring AI 文档
• DeepSeek-V4 预览版：迈入百万上下文普惠时代
• 微语文档中心