Stable Diffusion 接入
这篇解决什么
SD 平台字符串怎么填、通用绘制要带哪些 options。读完能对上 AiPlatformEnum.STABLE_DIFFUSION = "StableDiffusion",以及它只进图片工厂、不进对话工厂。
默认端口 48080。绘画总览见 AI 绘画创作。
示意图:走 Spring AI 的 Stability 客户端。url 空则用 SDK 默认主机。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 绘画 | POST /ai/image/draw | AiImageController |
| 工厂 | buildStabilityAiImageModel(apiKey, url) | AiModelFactoryImpl |
| 选项 | StabilityAiImageOptions | AiImageServiceImpl#buildImageOptions |
| 前端枚举 | sampler / stylePreset | ruoyi-office-vben/packages/constants/src/biz-ai-enum.ts |
官方菜单:AI 绘画 2783。没有「Stable Diffusion」独立菜单。
getOrCreateChatModel 没有 StableDiffusion。不要建 type=1 的 SD 对话行。图片模型 type=2。
draw.options 必须带 seed、scale、steps、sampler、stylePreset、clipGuidancePreset,缺了会在组选项时转数字失败。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 StableDiffusion | AiApiKeyDO / AiModelDO |
apiKey / url | 密钥;url 可选 | AiApiKeyDO |
model | Stability 图模名 | AiModelDO |
width / height | 尺寸 | AiImageDrawReqVO |
options | seed / scale / steps 等 | 同上 |
不是 SD 也不是 Stability
枚举值是 StableDiffusion。填 SD 会校验失败。
和 Midjourney 不是同一组接口
SD 走 /draw。MJ 走 /midjourney/imagine,见 Midjourney 接入。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=StableDiffusion(不是 SD)。再在 模型配置 建 type=2。出图走 AI 绘画 POST /draw,options 必须带 seed / scale / steps / sampler / stylePreset / clipGuidancePreset。
对话工厂没有这一家,不要建 type=1。和 Midjourney 不是同一组接口。开启见 AI 功能设计。

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

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