前言¶

在对话式开发环境里，「根据一段描述出一张图」往往还要切到网页控制台或自己接 HTTP。提示词、尺寸、参考图和结果 URL 分散在多步操作里，Agent 也很难按统一约定执行。若你已经在用 dLazy 托管的生成 API，更希望 Skill 只负责把「即梦文生图」封装成可复现的 CLI 调用，jimeng t2i 就是面向这一需求的社区 Skill。

这是什么¶

jimeng t2i（坐标 @user_f95f21b8/dlazy-jimeng-t2i）是 SkillHub 上分类为 design-media 的社区 Skill，当前版本 1.0.9。官方简介为：Text-to-image generation with Jimeng, quickly converting text to high-quality images.

Skill 本体遵循通用 SKILL.md 格式，由发布者 user_f95f21b8 上架；底层通过 dlazyai 维护的 @dlazy/cli 调用 dLazy 托管 API，对接即梦（Jimeng）文生图能力。SkillHub 页面标注 requires_api_key=true，使用前需配置 dLazy API Key。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md / SKILL-cn.md（v1.0.9）：

1. 文生图：以 --prompt 提交提示词，经 dlazy jimeng-t2i 调用后端，默认模型标识为 jimeng-t2i-v40。
2. 可选参考图：支持 --images，最多 10 张，可为 URL 或本地路径（本地文件会经 CLI 上传到 files.dlazy.com）。
3. 多种输出尺寸：--size 提供多组分辨率（默认 1440*2560），完整可选列表见下方用法中的 -h 输出。
4. 调试与异步：--dry-run 可打印 payload 与费用估算而不真正请求；--no-wait 返回 generateId，可用 dlazy status <generateId> --wait 轮询。
5. Agent 触发词：文档列出如 jimeng、即梦、文生图、generate image 等关键词，便于在对话中唤起该 Skill。

成功时 CLI 返回 JSON，其中 result.outputs 含图片 URL（托管于 files.dlazy.com）。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装文档 检查或安装：

command -v skillhub && skillhub --version

未安装时可执行：

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

2. 将 Skill 装到当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。SkillHub 文档给出的常见路径示例：

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

安装命令：

skillhub install @user_f95f21b8/dlazy-jimeng-t2i --dir ~/.cursor/skills/

也可让 AI 按官方页面提示，参照 https://skillhub.cn/install/skillhub.md 完成同一坐标的安装。

3. 安装并配置 dLazy CLI¶

Skill 元数据要求本机具备 npm / npx，并固定 CLI 版本 1.0.9：

npm install -g @dlazy/cli@1.0.9

或不全局安装、按需调用：

npx @dlazy/cli@1.0.9 <command>

配置 API Key（写入 ~/.dlazy/config.json，亦可用环境变量 DLAZY_API_KEY）：

dlazy auth set YOUR_API_KEY

Key 需在 dlazy.com 控制台 API Key 页 创建或复制。

典型用法¶

Agent 侧的核心指令是执行 dlazy jimeng-t2i 获取结果。先查看帮助：

dlazy jimeng-t2i -h

常用参数摘要（与官方文档一致）：

  --prompt [prompt]                    提示词
  --images [images...]                 参考图 [image: url or local path] (max 10)
  --size [size]                        尺寸 [default: 1440*2560]
  --dry-run                            打印 payload 与费用估算，不调用 API
  --no-wait                            异步任务立即返回 generateId
  --timeout <seconds>                  等待异步完成的最长时间（默认 1800）

基础文生图示例：

dlazy jimeng-t2i --prompt '夕阳下的城市天际线，赛博朋克风格'

带参考图时，官方示例为（注意示例中使用 --image 单数形式，与 -h 中的 --images 并存，以你本地 dlazy jimeng-t2i -h 为准）：

dlazy jimeng-t2i --prompt '提示词内容' --image '/path/to/image.png'

调用前可用 --dry-run 核对参数与预估消耗。

适用场景与注意¶

适合谁

• 已在 dLazy 开通 API、希望在 Cursor / Claude Code / 其他支持 Skill 的客户端里用自然语言驱动即梦文生图的团队或个人。
• 需要 Agent 统一走 dlazy 命令、输出结构化 JSON（含图片 URL）的自动化流程。

限制与注意

1. 依赖与网络：需 Node 生态（npm/npx）、可访问 api.dlazy.com 与 files.dlazy.com；提示词与上传的媒体会发往 dLazy 服务端，使用前请阅读 dlazy.com 服务条款。
2. 计费与余额：API 按 dLazy 账户计费；返回 insufficient_balance 时需到控制台充值（文档链接：https://dlazy.com/dashboard/organization/settings?tab=credits）。
3. 鉴权失败：unauthorized 表示 Key 缺失或无效，需重新 dlazy auth set 或设置 DLAZY_API_KEY。
4. 社区来源：SkillHub 标记来源为 community，上架者为 user_f95f21b8；CLI 源码在 github.com/dlazyai/cli，安装前可自行审阅。
5. SkillHub 数据（抓取时）：评分 100000，下载约 1110 次，安装记录 2；页面数据会变动，以 SkillHub 实时展示为准。

结尾¶

jimeng t2i 把即梦文生图收敛为 Skill + dlazy jimeng-t2i 一条链路：在 Agent 里写清提示词与尺寸，由 CLI 对接 dLazy API 并返回可下载的图片 URL。若你要从商店安装或核对版本，可参考：

• API 入口：https://api.skillhub.cn/user_f95f21b8/dlazy-jimeng-t2i
• SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-jimeng-t2i