前言¶
在 IDE 或 Agent 裏做配圖，常見做法是手寫一長串 shell，再對照即夢網頁端猜參數；任務一異步，終端裏還要自己記 submit_id、輪詢狀態和下載路徑。SkillHub 上的 即夢-文生圖 CLI 技能（@user_c1d16043/jimeng-cli-text2image）把安裝校驗、登錄、參數映射、標準執行流程和錯誤處理寫進 SKILL.md，智能體在用戶提到「即夢 CLI」「命令行生圖」或要提交/查詢文生圖任務時，會按同一套步驟調用字節跳動 dreamina 命令行，而不是臨時拼湊命令。
這是什麼¶
即夢-文生圖 CLI 技能 是面向 AI Agent 的操作指南型 Skill（當前版本 1.0.4，來源 community，分類 design-media）。發佈者爲 SkillHub 用戶 user_c1d16043（頁面標註作者 Loong10K）。它不負責替代即夢服務端，而是說明如何通過官方 dreamina CLI 向即夢（Dreamina/Jimeng）3.0～5.0 等文生圖模型提交任務，並覆蓋積分查詢、同步/異步提交、結果輪詢與會話（session）維度的項目組織。SkillHub 標籤 requires_api_key=false：認證走 CLI 登錄流程，不是在本 Skill 裏配置第三方 API Key。
核心功能¶
以下能力均來自 SkillHub 頁面與技能簡介的表述，可與官方 dreamina CLI 文檔對照使用。
- 觸發邊界：用戶要用已確認的提示詞在命令行出圖；提到
dreamina、即夢 CLI、生成/提交/執行 prompt；或需要查積分、任務狀態、會話管理、結果下載時，Agent 應加載本 Skill。 - 安裝與認證：包含安裝校驗（確認
dreamina可用）、登錄與賬號側檢查（如積分）。 - 參數映射：把自然語言或規格里的提示詞、畫幅、分辨率等映射爲 CLI 參數（具體 flag 以本機
dreamina text2image -h爲準）。 - 執行方式：支持同步等待與異步提交；異步場景下配合
query_result、任務列表等命令輪詢與取回結果。 - 流程與排錯：技能說明中歸納 4 條標準執行工作流 與 6 種常見錯誤處理模式（細節在安裝的
SKILL.md內，不在此重複編造）。 - 範圍限制：聚焦 文生圖（
dreamina text2image），不替代圖生圖、視頻生成或純提示詞創作類 Skill。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本 Skill 到當前 Agent 的 skills 目錄¶
SkillHub 要求 --dir 必須指向當前 Agent 實際讀取的 skills 目錄，否則技能不會被加載。安裝座標：
skillhub install @user_c1d16043/jimeng-cli-text2image --dir <你的 skills 目錄>
頁面給出的通用提示爲：依據 SkillHub 安裝說明 安裝 @user_c1d16043/jimeng-cli-text2image。
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔，按你當前環境選用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝後需按各客戶端要求刷新或重啓，使新 Skill 生效。
3. 安裝並登錄 dreamina CLI（生圖二進制）¶
本 Skill 指導的是 dreamina 命令行。官方一鍵安裝示例（字節跳動即夢 CLI 倉庫文檔）：
curl -fsSL https://jimeng.jianying.com/cli | bash
默認將 dreamina 安裝到 ~/.local/bin/。遠程或無圖形環境時，可用無頭掃碼登錄：
dreamina login --headless
登錄後可用積分接口確認會話是否有效：
dreamina user_credit
典型用法¶
下面示例來自官方 dreamina CLI 文檔中的文生圖與異步查詢用法；Agent 在實際執行前應運行 dreamina text2image -h 覈對當前版本支持的參數。生成命令會消耗即夢積分，提交前應向用戶說明。
同步或帶輪詢的文生圖（指定比例與分辨率類型）：
dreamina text2image \
--prompt="cyberpunk cityscape at night, neon reflections" \
--ratio=1:1 \
--resolution_type=2k
異步任務：先提交，再按 submit_id 查詢並下載：
dreamina query_result --submit_id=3f6eb41f425d23a3 --download_dir=./output
查看歷史任務（便於接續未完成的異步生成）：
dreamina list_task --gen_status=success
文生圖模型與 resolution_type 的對應關係（如 3.0/3.1 支持 1k/2k，4.x/5.0 支持 2k/4k 等）以官方 CLI 幫助與即夢側說明爲準；技能內的參數映射應與此保持一致。
適用場景與注意¶
適合：已在 Agent 工作流裏固定使用即夢賬號；希望把「裝 CLI → 登錄 → 提交文生圖 → 輪詢/下載」交給智能體按步驟完成；需要統一處理 CLI 報錯與會話管理的團隊或個人。
注意：
- 本 Skill 爲 community 維護，與官方 dreamina 倉庫自帶的 Agent Skill 路徑不同；以 SkillHub 安裝的
SKILL.md爲 Agent 行爲準則。 - 部分模型可能需要在即夢網頁端完成一次性授權後才能通過 CLI 調用。
- 異步任務務必保留
submit_id，並在終端側正確處理「任務未完成 / 超時 / 積分不足」等狀態；具體對策見技能內 6 類錯誤模式說明。 - SkillHub 頁面統計（抓取時）：評分 100000，下載 32183 次；安裝量以商店展示爲準。
結尾¶
即夢-文生圖 CLI 技能 把即夢文生圖從「臨時查文檔寫命令」收斂爲 Agent 可重複執行的流程：安裝校驗、認證、參數映射、同步/異步提交與排錯模板都在 Skill 內對齊。若你的智能體需要在對話裏穩定跑 dreamina text2image，可從 SkillHub 安裝 @user_c1d16043/jimeng-cli-text2image。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_c1d16043/jimeng-cli-text2image
- API/分享地址：https://api.skillhub.cn/user_c1d16043/jimeng-cli-text2image
- SkillHub 安裝說明：https://skillhub.cn/install/skillhub.md
