前言¶
在 Cursor、Claude Code 等環境裏做配圖,常見做法是手寫 HTTP 請求、自己管鑑權與上傳參考圖,再把返回 URL 塞回對話。步驟多,也容易和項目裏的其他 Skill 安裝方式不一致。
下面介紹 SkillHub 上的 seedream 5.0 lite(座標 @user_f95f21b8/dlazy-seedream-5-0-lite)。它把豆包 Doubao Seedream 5.0 Lite 封裝成標準 SKILL.md,通過 dLazy CLI 調用雲端 API,支持文生圖與圖生圖。Skill 當前版本 1.0.9,來源爲社區(community),分類 design-media,標籤含 requires_api_key=true。
這是什麼¶
seedream 5.0 lite 是一枚面向設計與媒體場景的 Agent Skill。官方簡介爲:Fast image generation with Doubao Seedream 5.0 Lite. Supports text-to-image and image-to-image.
技能包內標識爲 dlazy-seedream-5.0-lite,由社區發佈者 user_f95f21b8 上架 SkillHub;底層 CLI 由 dlazyai 維護(npm 包 @dlazy/cli,技能元數據固定版本 1.0.9)。推理經 dLazy 託管 API(api.dlazy.com),生成結果 URL 落在 files.dlazy.com。
核心功能¶
依據技能包 SKILL.md / SKILL-cn.md,可覈實的能力如下:
- 文生圖、圖生圖:通過
--prompt與參考圖參數發起生成;幫助信息中參考圖爲--images(最多 10 張,支持 URL 或本地路徑)。 - 畫面參數:
--resolution可選2k、3k(默認2k);--size可選多種寬高比(默認16:9)。 - 調用前預估:
--dry-run可打印請求體與費用估算而不真正調用 API。 - 異步:
--no-wait返回generateId,可用dlazy status <generateId> --wait輪詢;--timeout默認等待 1800 秒。 - 觸發詞:技能文檔列出如 seedream、文生圖、圖生圖、極速生圖等,便於 Agent 路由到本 Skill。
成功時 CLI 返回 JSON,modelId 爲 doubao-seedream-5_0-lite,outputs 中含圖片 URL。
安裝與啓用¶
1. 通過 SkillHub 安裝技能¶
SkillHub 頁面給出的安裝指引是:讓 Agent 按 https://skillhub.cn/install/skillhub.md 安裝座標 @user_f95f21b8/dlazy-seedream-5-0-lite。
若本機已有 skillhub CLI,需把技能裝到當前 Agent 識別的 skills 目錄(安裝文檔強調使用 --dir,否則默認 ./skills/ 可能不會被加載)。常見路徑示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下.agents/skills/
示例命令(將 <skills 目錄> 換成你環境中的實際路徑):
skillhub install @user_f95f21b8/dlazy-seedream-5-0-lite --dir <skills 目錄>
未安裝 CLI 時,可先按 SkillHub 安裝文檔執行官方 curl 安裝腳本,再執行上面的 skillhub install。
2. 安裝並配置 dLazy CLI¶
技能元數據要求環境具備 npm / npx,並依賴 @dlazy/cli@1.0.9:
npm install -g @dlazy/cli@1.0.9
也可不全局安裝,按需調用:
npx @dlazy/cli@1.0.9 <command>
所有請求需要 dLazy API Key。在控制台 dlazy.com/dashboard/organization/api-key 獲取後寫入本地配置:
dlazy auth set YOUR_API_KEY
密鑰保存在 ~/.dlazy/config.json(Windows 爲 %USERPROFILE%\.dlazy\config.json),也可單次使用環境變量 DLAZY_API_KEY。
典型用法¶
Agent 側應執行 dlazy seedream-5.0-lite 獲取結果。先查看完整參數:
dlazy seedream-5.0-lite -h
技能文檔中的示例如下(注意示例裏使用 --image,與 -h 中的 --images 命名並存,以你本地 dlazy seedream-5.0-lite -h 輸出爲準):
# 帶本地參考圖
dlazy seedream-5.0-lite --prompt '提示詞內容' --image '/path/to/image.png'
# 帶遠程參考圖
dlazy seedream-5.0-lite --prompt '提示詞內容' --image 'https://files.dlazy.com/image.png'
僅文生圖時,按幫助要求提供 --prompt,不傳參考圖即可(缺少必填項時 CLI 會報錯,例如未指定 --prompt)。
返回結構示意(字段以實際 stdout 爲準):
{
"ok": true,
"result": {
"tool": "seedream-5.0-lite",
"modelId": "doubao-seedream-5_0-lite",
"outputs": [
{
"type": "image",
"url": "https://files.dlazy.com/result.png",
"mimeType": "image/png"
}
]
}
}
適用場景與注意¶
適合誰
- 已在用 SkillHub 管理技能,希望在 Agent 對話裏快速出圖、改圖,而不想自建豆包/OpenAPI 封裝。
- 能接受雲端 SaaS:提示詞與本地參考圖會經 dLazy 上傳與推理,結果託管在
files.dlazy.com。
限制與注意
- 必須自備 API Key 與賬戶額度:
401 unauthorized表示密鑰缺失或無效;insufficient_balance表示餘額不足,需在 dLazy 控制台充值後再試。 - 網絡與依賴:需能訪問 dLazy API 與 npm 源;技能不替代 CLI,Agent 實際執行的是
dlazy命令。 - 安全與合規:本地路徑錯誤會觸發文件讀取失敗;後端也可能因策略拒絕提示詞(異步失敗時可見具體原因)。
- SkillHub 統計(抓取時點):評分 100000,下載 1422,安裝 5;上架版本 1.0.9。頁面數據會變動,以 SkillHub 爲準。
結尾¶
seedream 5.0 lite 把 Doubao Seedream 5.0 Lite 的圖像生成能力收斂成「裝 Skill + 配 dLazy CLI + 一條 dlazy seedream-5.0-lite 命令」,適合在 Agent 工作流裏做文生圖與圖生圖。官方入口: