前言¶

在對話式開發環境裏，「根據一段描述出一張圖」往往還要切到網頁控制台或自己接 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