mj-imagine:在 Agent 里调用 Midjourney 文生图

前言

在对话里直接出图,常见做法是切到 Midjourney 网页或 Discord,把提示词复制过去再等结果。若你希望 Cursor、Claude Code 等带 Skills 的 Agent 在任务流里完成「写提示词 → 调模型 → 拿回图片 URL」,需要一条可复用的技能封装,而不是每次手写 HTTP 请求。

下面介绍 SkillHub 上的 mj-imagine(坐标 @user_f95f21b8/dlazy-mj-imagine,当前版本 1.0.9)。它把 dLazy 托管的 Midjourney 推理能力接到 Agent 侧,通过 @dlazy/cli 执行 dlazy mj.imagine,支持纯文本生图。

这是什么

mj-imagine 是社区来源(community)的 Skill,分类为 design-media,由发布者 user_f95f21b8 上架。官方简介为:

Generate artistic images using Midjourney (MJ) model. Supports text-to-image.

技能包内标识为 dlazy-mj.imagine,实质是 dLazy API 的薄封装:提示词与参数发往 api.dlazy.com,生成结果 URL 由 files.dlazy.com 返回。CLI 由 dlazyai 维护,源码见 github.com/dlazyai/cli。

SkillHub 页面统计(以商店展示为准):评分 100000,下载约 1200 次;标签含 requires_api_key=true,使用前需配置 dLazy API Key。

核心功能

根据技能包 SKILL.md 与 SkillHub 简介,已核实能力如下:

  1. 文生图:通过 Midjourney 模型生成艺术向图像(modelId: mj_imagine)。
  2. 画幅与机型:--aspect_ratio 支持 auto、1:1、4:3、16:9 等;--botType 可选 MID_JOURNEY 或 NIJI_JOURNEY。
  3. 输出形式:--output 默认为四宫格 grid,也可指定 U1–U4 单张放大结果。
  4. 调试与异步:--dry-run 可查看请求载荷与费用估算;--no-wait 返回 generateId,可用 dlazy status <generateId> --wait 轮询。
  5. 触发词:技能说明中列出 midjourney、mj、文生图相关表述,便于 Agent 路由到本 Skill。

依赖环境需具备 npm / npx;CLI 固定版本为 @dlazy/cli@1.0.9。

安装与启用

1. 安装 SkillHub CLI(若尚未安装)

command -v skillhub && skillhub --version

未安装时可按 SkillHub 文档执行完整安装:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明见 skillhub.cn/install/skillhub.md。

2. 将 mj-imagine 装进当前 Agent 的 skills 目录

安装时必须用 --dir 指向 Agent 实际识别的 skills 路径,否则默认落在 ./skills/ 可能无法加载。常用路径示例:

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下 .agents/skills/

搜索与安装命令(与 skillhub search 输出一致):

skillhub search mj-imagine

skillhub install dlazy-mj-imagine --namespace user_f95f21b8 --dir ~/.cursor/skills/

也可让 Agent 按官方提示安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_f95f21b8/dlazy-mj-imagine`。

安装后重启或刷新 Agent,使 Skills 生效。

3. 安装并配置 dLazy CLI

全局安装(与技能 metadata 中声明一致):

npm install -g @dlazy/cli@1.0.9

或不落盘全局包、按需调用:

npx @dlazy/cli@1.0.9 <command>

配置 API Key(写入 ~/.dlazy/config.json,Windows 为 %USERPROFILE%\.dlazy\config.json):

dlazy auth set YOUR_API_KEY

也可单次通过环境变量传入:

export DLAZY_API_KEY=YOUR_API_KEY

Key 在 dlazy.com/dashboard/organization/api-key 获取,需先在 dlazy.com 注册或登录。

典型用法

Agent 侧应按技能说明执行 dlazy mj.imagine。先查看帮助:

dlazy mj.imagine -h

基础文生图(--prompt 为必填):

dlazy mj.imagine --prompt 'a watercolor cityscape at dusk, soft lighting'

指定画幅与 Niji 风格:

dlazy mj.imagine \
  --prompt 'anime character portrait, detailed eyes' \
  --aspect_ratio 9:16 \
  --botType NIJI_JOURNEY \
  --output grid

技能文档中的带图示例(本地或远程参考图):

dlazy mj.imagine --prompt '提示词内容' --image '/path/to/image.png'

dlazy mj.imagine --prompt '提示词内容' --image 'https://files.dlazy.com/image.png'

成功时 CLI 返回 JSON,outputs 中含 url 指向 files.dlazy.com 上的 PNG。若使用 --no-wait,需再执行 dlazy status <generateId> --wait 等待完成。

在对话里,你可以用自然语言描述画面,并说明画幅或 MID_JOURNEY / NIJI_JOURNEY,由 Agent 拼装上述参数后执行命令。

适用场景与注意

适合谁

  • 已在用 Cursor、Claude Code 等 Skills 能力,希望在同一上下文里生成 Midjourney 风格配图的设计、运营或前端同学。
  • 愿意使用 dLazy 托管 API(按量计费、需自备 Key)而不是自建 MJ 代理的团队。

限制与注意

  1. 必须联网且需 API Key:未配置或 Key 无效会返回 unauthorized;余额不足时 code 为 insufficient_balance,需在 dlazy.com 积分设置 充值。
  2. 数据出境路径:提示词与上传的本地文件会经 dLazy 上传到其 API 与媒体存储,使用前请对照组织合规要求。
  3. CLI 版本锁定:技能固定 @dlazy/cli@1.0.9,升级 CLI 前建议对照 SkillHub 上技能版本是否同步更新。
  4. 安全与内容策略:后端可能拒绝违规提示词(例如返回 safety policy 相关错误),需在提示词侧自行把控。

结尾

mj-imagine 把 Midjourney 文生图收敛成 Agent 可调用的 dlazy mj.imagine 命令:SkillHub 负责分发技能包,dLazy CLI 负责鉴权与 API 调用。若你的痛点是「在编码或写稿对话里顺手出图」,可按上文完成 Skill 与 CLI 安装,再配置 API Key 即可试用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜