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 工作流裏做文生圖與圖生圖。官方入口:

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

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

小夜