前言¶

在智能体里做图生图，常见做法是手写一段 dreamina image2image 命令，或让模型凭记忆拼参数。一旦涉及多张本地参考图、--images 逗号分隔、CLI v1.4.14 必填的 resolution_type、模型与 1k/2k/4k 限制，以及 querying 与终态 success/fail 的区分，很容易提交失败或把「已提交」当成「已出图」。下面介绍 SkillHub 上的社区 Skill 即梦-图生图 CLI 技能，把图生图编辑的执行边界、参数约定和异步闭环写进 SKILL.md，供 Agent 在合适时机自动加载。

这是什么¶

即梦-图生图 CLI 技能（坐标 @user_c1d16043/jimeng-cli-image2image，当前版本 1.0.3，分类 design-media，来源 community，发布者 user_c1d16043）是一份面向 Coding Agent 的操作说明：在用户已有 1–10 张本地图片、需要通过 Dreamina / 即梦 CLI 做图生图（dreamina image2image）时，指导智能体完成校验、提交、轮询与排错。

它不替代 dreamina 可执行文件本身，也不覆盖文生图、视频生成或纯提示词润色；那些场景应使用同仓库体系下的其他技能。技能页标注 requires_api_key=false，表示 Skill 安装本身不额外要求 SkillHub API Key；实际调用仍依赖本机已配置好的 dreamina CLI 环境。

官方入口：

• API / 安装坐标：https://api.skillhub.cn/user_c1d16043/jimeng-cli-image2image
• SkillHub 展示页：https://www.skillhub.cn/skills/user_c1d16043/jimeng-cli-image2image

（SkillHub 页面当前展示：评分约 100000，下载 2919 次。）

核心功能¶

结合技能 SKILL.md 与配套 reference，已核实的能力包括：

1. 触发边界：用户提到 dreamina image2image、图生图CLI、编辑图片，或提供参考图并要求变换；编辑提示词已确认后执行；需要查积分、查任务、管 session 时也可启用。
2. 输入约束：--images 接受 1–10 个本地可读文件，多路径用英文逗号分隔；执行前建议 test -r 或 ls 验证文件。
3. CLI v1.4.14 契约：每次提交需显式传 --resolution_type=1k|2k|4k；--width 与 --height 须成对、为正整数，且与 --ratio 互斥；generate_num 范围 1–10。完整模型矩阵见技能引用的 dreamina-cli v1.4.14 参数契约。
4. 模型与分辨率：面向即梦 4.0+ 图生图；技能说明中 4.x / 5.0 图生图仅支持 2k 或 4k；1k 仅 5.0Pro 支持（勿与文生图规则混用）。
5. 标准工作流：技能内归纳 4 种 I2I 工作流——单图编辑、批量循环提交、多图参考合成、与提示词技能协作后再执行；并强调异步闭环：submit_id → query_result，直到 success 或 fail，querying 不是成功终态。
6. 配套文档：参数参考、模型选择、工作流模式及 examples/ 下的基础生成、异步、批量、session 等示例（均围绕 dreamina image2image）。

执行前技能要求先运行 dreamina image2image -h，以终端 help 为参数事实源；技能正文记录的是 v1.4.14 下已验证的稳定写法。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按 SkillHub 安装说明 安装本技能，坐标为：

@user_c1d16043/jimeng-cli-image2image

技能还建议：若本地尚未有 dreamina-cli 参数契约技能，可先安装同仓库的 CLI 总览技能，便于核对版本与字段：

npx skills add full-aigc-skills/jimeng-skills --skill dreamina-cli

本机需已安装并可调用 dreamina 命令；图生图前可用 dreamina user_credit 查看积分。Cursor、Codex CLI、Claude Code 等具体菜单差异以各产品当前的 Skills 加载方式为准，SkillHub 统一走上述坐标与 skillhub.md 流程。

典型用法¶

1. 最简单图编辑（固定比例）¶

先确认输入可读，再提交；--poll=0 表示异步提交后自行查询（与技能标准示例一致）：

test -r ./input.png
dreamina user_credit
dreamina image2image \
  --images=./input.png \
  --prompt="保留主体与构图，转换为透明水彩风格" \
  --model_version=5.0 \
  --resolution_type=2k \
  --ratio=1:1 \
  --poll=0

2. 自定义宽高（不用 ratio）¶

宽高成对传入，且不要同时传 --ratio：

dreamina image2image \
  --images=./input.png \
  --prompt="改造成竖版电商海报" \
  --model_version=5.0 \
  --resolution_type=2k \
  --width=1536 \
  --height=2048 \
  --poll=0

3. 多图参考（逗号分隔）¶

工作流文档中的多图合成示例：

dreamina user_credit
ls -la ./subject.png ./style.png ./background.png
dreamina image2image \
  --resolution_type=2k \
  --images ./subject.png,./style.png,./background.png \
  --prompt="参考第一张的人物特征，应用第二张的水墨风格，配上第三张的竹林背景。所有元素光源方向统一。全局色调协调。" \
  --poll=30

4. 异步闭环三步¶

技能规定的闭环与常见失误：

1. 验证：逐个检查图片可读；用 help 核对模型、resolution_type、ratio 或自定义尺寸是否合法。
2. 提交：dreamina user_credit 后提交，保存返回的 submit_id。
3. 终态：对仍处于 querying 的任务反复 query_result，直到 success 或 fail；失败需带上 fail_reason，不能把提交成功当作生成成功。

适用场景与注意¶

适合谁

• 已在 Agent 工作流里集成即梦 CLI，需要图生图路径有统一「说明书」的团队或个人。
• 用户一次提供多张本地参考图，或需要批量、session、任务列表配合图生图的场景。
• 希望智能体在用户说「图生图」「编辑图片」时自动走校验 + 积分 + 轮询，而不是只生成一段可能漏参的命令。

限制与坑

更细的参数表与错误对照见技能包内 references/parameter-reference.md、references/workflow-patterns.md 及 examples/ 目录（随 Skill 安装一并下发）。

结尾¶

即梦-图生图 CLI 技能把 dreamina image2image 在 v1.4.14 下的输入格式、分辨率与模型限制、四类工作流和异步终态处理写进 Agent 可加载的 Skill，减少「命令拼对了但业务规则错了」的情况。需要安装或查看说明时，请打开官方地址：https://api.skillhub.cn/user_c1d16043/jimeng-cli-image2image（展示页：https://www.skillhub.cn/skills/user_c1d16043/jimeng-cli-image2image）。