seedream 5.0 lite:在 Agent 里调用豆包 Seedream 5.0 Lite 做文生图与图生图

前言

在 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,可核实的能力如下:

  1. 文生图、图生图:通过 --prompt 与参考图参数发起生成;帮助信息中参考图为 --images(最多 10 张,支持 URL 或本地路径)。
  2. 画面参数:--resolution 可选 2k、3k(默认 2k);--size 可选多种宽高比(默认 16:9)。
  3. 调用前预估:--dry-run 可打印请求体与费用估算而不真正调用 API。
  4. 异步:--no-wait 返回 generateId,可用 dlazy status <generateId> --wait 轮询;--timeout 默认等待 1800 秒。
  5. 触发词:技能文档列出如 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。

限制与注意

  1. 必须自备 API Key 与账户额度:401 unauthorized 表示密钥缺失或无效;insufficient_balance 表示余额不足,需在 dLazy 控制台充值后再试。
  2. 网络与依赖:需能访问 dLazy API 与 npm 源;技能不替代 CLI,Agent 实际执行的是 dlazy 命令。
  3. 安全与合规:本地路径错误会触发文件读取失败;后端也可能因策略拒绝提示词(异步失败时可见具体原因)。
  4. 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 工作流里做文生图与图生图。官方入口:

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜