前言¶
在对话里直接出图,常见做法是切到 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 简介,已核实能力如下:
- 文生图:通过 Midjourney 模型生成艺术向图像(
modelId:mj_imagine)。 - 画幅与机型:
--aspect_ratio支持auto、1:1、4:3、16:9等;--botType可选MID_JOURNEY或NIJI_JOURNEY。 - 输出形式:
--output默认为四宫格grid,也可指定U1–U4单张放大结果。 - 调试与异步:
--dry-run可查看请求载荷与费用估算;--no-wait返回generateId,可用dlazy status <generateId> --wait轮询。 - 触发词:技能说明中列出
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 代理的团队。
限制与注意
- 必须联网且需 API Key:未配置或 Key 无效会返回
unauthorized;余额不足时code为insufficient_balance,需在 dlazy.com 积分设置 充值。 - 数据出境路径:提示词与上传的本地文件会经 dLazy 上传到其 API 与媒体存储,使用前请对照组织合规要求。
- CLI 版本锁定:技能固定
@dlazy/cli@1.0.9,升级 CLI 前建议对照 SkillHub 上技能版本是否同步更新。 - 安全与内容策略:后端可能拒绝违规提示词(例如返回 safety policy 相关错误),需在提示词侧自行把控。
结尾¶
mj-imagine 把 Midjourney 文生图收敛成 Agent 可调用的 dlazy mj.imagine 命令:SkillHub 负责分发技能包,dLazy CLI 负责鉴权与 API 调用。若你的痛点是「在编码或写稿对话里顺手出图」,可按上文完成 Skill 与 CLI 安装,再配置 API Key 即可试用。