前言¶

在智能體裏做圖生圖，常見做法是手寫一段 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）。