前言¶
在 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 工作流里做文生图与图生图。官方入口: