DeepSeek 接入
这篇解决什么
DeepSeek 平台字符串怎么填、对话选项走哪套客户端。读完能对上 AiPlatformEnum.DEEP_SEEK = "DeepSeek",以及推理内容来自 DeepSeekAssistantMessage。
默认端口 48080。开启见 AI 功能设计。推理展示见 推理模式。
示意图:密钥来自库表。url 空则用 DeepSeek 默认 Base URL。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 模型 | /ai/model | AiModelController |
| 工厂 | buildDeepSeekChatModel(apiKey, url) | AiModelFactoryImpl |
| 选项 | DeepSeekChatOptions | AiUtils.buildChatOptions |
| 管理端 | 密钥、模型页 | ruoyi-office-vben/apps/web-antd/src/views/ai/model/ |
官方菜单:API 密钥 2761,模型配置 2767。没有「DeepSeek」独立菜单。
国内多家(豆包、智谱、月之暗面等)对话选项也复用 DeepSeekChatOptions,但 platform 必须各写各的。本篇只配 DeepSeek。
/ai/image/draw 没有 DeepSeek 分支。不要建 type=2 的 DeepSeek 绘画行指望能出图。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 DeepSeek | AiApiKeyDO / AiModelDO |
apiKey / url | 密钥;url 可选 | AiApiKeyDO |
model | 对话模型标识 | AiModelDO |
流式结束后,若 output 是 DeepSeekAssistantMessage,reasoningContent 从它取值。
不要填成硅基流动
硅基上的 DeepSeek 蒸馏模型,平台应是 SiliconFlow。本篇是官方 DeepSeek 密钥那条。
和 OpenAI 不是同一套 Options
OpenAI 走 OpenAiChatOptions,见 OpenAI 接入。DeepSeek 走 DeepSeekChatOptions。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=DeepSeek,再在 模型配置(2767)建 type=1 对话行。没有独立菜单。国内多家选项类也复用 DeepSeekChatOptions,但 platform 必须各写各的。
/ai/image/draw 没有 DeepSeek 分支,不要建 type=2 指望出图。硅基上的蒸馏模型应填 SiliconFlow。开启见 AI 功能设计。

本系统截图:AI 大模型 → 控制台 → API 密钥。各厂商共用这一页,用 platform 区分。

本系统截图:控制台 → 模型配置。keyId 必须指向同平台密钥。
