Midjourney 是一个由位于美国加州旧金山的同名研究实验室开发之人工智能程序，可根据文本生成图像，于 2022 年 7 月 12 日进入公开测试阶段，用户可透过 Discord 的机器人指令进行操作。

由于 Midjourney 没有直接提供 API 接口，所以大家一般通过 https://github.com/novicezk/midjourney-proxy/ (opens new window) 项目，代理 MidJourney 的 Discord 频道，实现 API 形式调用 AI 绘图。

也因此，Spring AI 肯定是不集成 Midjourney 的，所以我们实现的 models/midjourney 包下的 MidjourneyApi 类，基于上述的 midjourney-proxy 代理，调用 Midjourney 实现绘图的功能。

1. 申请密钥

可参考 https://github.com/novicezk/midjourney-proxy/blob/main/README_CN.md (opens new window) 文档，申请相关账号，并搭建 midjourney-proxy 代理。

不过这个方式比较麻烦，我自己暂时没跑通。我是在 毫秒 API (opens new window) 注册了一个账号，然后通过他们的 API 代理 Midjourney 的。这个是需要付费的，测试的话，建议只小额充值 1-10 块。

---

申请完成后，可以在我们系统的 [AI 大模型 -> 控制台 -> API 密钥] 菜单，进行密钥的配置。需要填写“密钥” + “自定义 API URL”。如下图所示：

2. AI 绘图

后续使用 《AI 图片生成》 时，需要在 [AI 大模型 -> 控制台 -> 模型配置] 菜单，配置对应的图片模型：所属平台选择「Midjourney」，模型类型选择「图片」。

模型有：midjourney、niji 等等。模型主要用于选择 API 密钥，具体的版本（Midjourney V8.2、V8.1、V7、V6.1，Niji 7、Niji 6）在绘图工作台的「版本」中选择，拼接为 --v 7、--niji 6 等参数。

绘图工作台支持文生图、图生图、融图、换脸、一致性五种模式，以及 U、V 等按钮和局部重绘，使用说明见 《AI 图片生成》 的「2.3 Midjourney」「2.5 Midjourney 按钮与局部重绘」小节。它们需要中转提供以下接口：

功能	中转接口
文生图、图生图、一致性	/submit/imagine
按钮（U、V 等）	/submit/action
融图	/submit/blend
换脸	/insight-face/swap
局部重绘	先 /submit/action 执行局部重绘按钮，再 /submit/modal 提交蒙版
同步进展	/task/list-by-condition

中转不支持某个接口（返回 HTTP 404）时，作品会直接失败，失败原因为“中转不支持该接口”。

3. 如何使用？

① 如果你的项目里需要直接通过 @Resource 注入 MidjourneyApi 对象，需要把 application.yaml 配置文件里的 yudao.ai.midjourney.image 配置项，替换成你的！

yudao:
  ai:
    midjourney:
      image:
        enable: true
        base-url: https://api.holdai.top/mj
        api-key: sk-dZEPiVaNcT3FHhef51996bAa0bC74806BeAb620dA5Da10Bf
        notify-url: http://java.nat300.top/admin-api/ai/image/midjourney/notify

• base-url：Midjourney 代理的地址，相关的接口文档可见 https://gpt-best.apifox.cn/doc-3530863 (opens new window)
• notify-url：Midjourney 生成图片后的回调地址，因为 Midjourney 生成图片是异步的，所以需要回调通知。这个 URL 可以分成两个小部分：
  • http://java.nat300.top：你的服务器地址。如果你没外网，可以通过 《内网穿透》 解决
  • /admin-api/ai/image/midjourney/notify：对应 AiImageController 的 #midjourneyNotify(...) 方法

另外，考虑到 Midjourney 回调失败的情况，需要开启项目的 AiMidjourneySyncJob 定时任务，同步未回调的图片，配置方式见 《AI 图片生成》 的「1.2 开启定时任务」小节。

② 如果你希望使用 [AI 大模型 -> 控制台 -> API 密钥] 菜单的密钥配置，则可以通过 AiModelService 的 #getMidjourneyApi() 方法，获取对应的 MidjourneyApi 对象。

另外，MidjourneyApiTests 里有对应的测试用例，可以参考。