seedance 2.0:在 Agent 裏調用 ByteDance Seedance 2.0 視頻生成

前言

在 IDE 或 CLI 裏做視頻生成,常見做法是單獨打開控制台、手工上傳參考素材、再複製任務 ID 輪詢結果。流程長,也不方便把「寫提示詞 → 調模型 → 拿成片 URL」嵌進自動化腳本。

下面介紹 SkillHub 上的 seedance 2.0(座標 @user_f95f21b8/dlazy-seedance-2-0,當前版本 1.0.9)。它把 dLazy CLI 與託管 API 封裝成標準 Skill:Agent 按 SKILL.md 執行 dlazy seedance-2.0,即可走多模態參考、首尾幀或純文本生成視頻,而無需你每次手寫 HTTP 請求。

這是什麼

seedance 2.0 是社區來源(source: community)的 design-media 類 Skill,SkillHub 子分類爲「視頻處理」。頁面簡介寫明:面向 ByteDance 最新視頻生成模型,支持用圖像、視頻、音頻作多模態參考生成視頻,並支持首尾幀模式與文生視頻。

技能本體不內置模型權重,而是 dLazy 託管 API 的薄客戶端:提示詞與參數發往 api.dlazy.com,本地參考文件由 CLI 上傳到 files.dlazy.com,返回的成片 URL 同樣託管在該域名。CLI 由 dlazyai 維護,npm 包爲 @dlazy/cli(本 Skill 固定 1.0.9)。SkillHub 發佈者爲 user_f95f21b8(展示名 dLazy)。

截至 SkillHub 頁面數據:下載約 2096 次,安裝約 10 次;標籤 requires_api_key=true,使用前必須配置 dLazy API Key。

核心功能

以下能力均來自 Skill 包內 SKILL.md / SKILL-cn.md 與官方簡介,可按命令行參數組合使用。

  1. 多模態參考(generation_mode=components,默認)
    - --images:最多 9 張參考圖(URL 或本地路徑)
    - --videos:最多 3 段參考視頻
    - --audios:最多 3 段參考音頻

  2. 首尾幀模式(generation_mode=frames)
    - --firstFrame、--lastFrame:首幀與尾幀圖像,用於控制起止畫面。

  3. 文生視頻
    - 通過必填的 --prompt 描述畫面;可與上述模式配合(首尾幀模式下不傳 images/videos/audios 參考項)。

  4. 輸出與畫幅
    - 分辨率:480p / 720p(默認) / 1080p
    - 比例:21:9、16:9(默認)、4:3、1:1、3:4、9:16
    - 時長:4–15 秒(默認 5 秒)
    - --generate_audio:是否生成音頻(默認 true)

  5. 任務控制
    - --dry-run:只打印請求體與費用估算,不調用 API
    - --no-wait:異步返回 generateId,可用 dlazy status <generateId> --wait 輪詢
    - --timeout:等待異步完成的最長時間(默認 1800 秒)

後端模型標識在成功響應中爲 modelId: "doubao-seedance-2_0"。

安裝與啓用

安裝分兩層:先把 Skill 裝進 Agent 的 skills 目錄,再確保本機有 dLazy CLI 與 API Key。

1. 通過 SkillHub 安裝 Skill

若已安裝 skillhub CLI,將 Skill 裝到當前 Agent 識別的目錄(必須使用 --dir,否則默認 ./skills/ 可能不會被加載):

skillhub install @user_f95f21b8/dlazy-seedance-2-0 --dir <你的 skills 目錄>

常見路徑(來自 SkillHub 安裝文檔):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或項目下 .agents/skills/

也可讓 AI 按同一文檔安裝,提示詞示例爲:請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_f95f21b8/dlazy-seedance-2-0。

未安裝 skillhub 時,可先執行:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安裝 dLazy CLI

Skill 元數據要求本機具備 npm 與 npx。全局安裝固定版本:

npm install -g @dlazy/cli@1.0.9

若不想全局安裝,可按次調用:

npx @dlazy/cli@1.0.9 <command>

3. 配置 API Key

在 dlazy.com 註冊後,於 組織 API Key 頁面 複製密鑰,寫入 CLI:

dlazy auth set YOUR_API_KEY

密鑰保存在 ~/.dlazy/config.json(Linux/macOS);也可用環境變量 DLAZY_API_KEY 按次傳入。

典型用法

Agent 側的核心指令是執行 dlazy seedance-2.0 獲取結果。先查看完整參數:

dlazy seedance-2.0 -h

官方文檔中的最小文生視頻示例:

dlazy seedance-2.0 --prompt '提示詞內容'

多模態參考時,在 components 模式下追加參考資源,例如本地圖片與提示詞(路徑需真實存在,否則會觸發本地文件讀取錯誤):

dlazy seedance-2.0 \
  --prompt '根據參考圖風格生成一段短片' \
  --images /path/to/reference.png \
  --resolution 1080p \
  --ratio 16:9 \
  --duration 8

首尾幀示例思路相同,將 --generation_mode 設爲 frames,並傳入 --firstFrame / --lastFrame。

成功時 CLI 返回 JSON,result.tool 爲 seedance-2.0,outputs 中含 url 等字段;使用 --no-wait 時需後續 dlazy status 查詢。

適用場景與注意

適合誰

  • 已在 Cursor、Claude Code、Codex 等環境使用 Skills,希望用自然語言驅動 Seedance 2.0 成片。
  • 需要同一套 CLI 在終端與 Agent 間複用:參數、異步任務、費用預估(--dry-run)行爲一致。
  • 需要多參考圖/音視頻、首尾幀或可調分辨率與畫幅的短視頻生成流水線。

限制與注意

  1. 付費與密鑰:依賴 dLazy 賬戶餘額;insufficient_balance 時需到控制台充值;未配置 Key 會返回 unauthorized。
  2. 數據出境:提示詞與上傳的本地媒體會進入 dLazy 雲端,需符合你方數據合規要求。
  3. 依賴環境:需 Node 生態下的 npm/npx;Skill 爲社區發佈,與 ByteDance 官方無 SkillHub「作者認證」綁定,使用前可在 github.com/dlazyai/cli 審閱 CLI 源碼。
  4. 安全掃描:SkillHub 頁面展示的安全報告狀態爲「安全,無風險」,仍建議只向 CLI 傳入可信路徑與 URL。

結尾

seedance 2.0 把 Seedance 2.0 的視頻能力收斂成 Agent 可執行的 dlazy seedance-2.0 命令:多模態參考、首尾幀與文生視頻在同一套參數模型下完成。若你正在 SkillHub 選型視頻類 Skill,可從官方頁面查看版本與統計信息:

  • SkillHub:https://www.skillhub.cn/skills/user_f95f21b8/dlazy-seedance-2-0
  • API 入口(Skill 線索頁):https://api.skillhub.cn/user_f95f21b8/dlazy-seedance-2-0
羽毛球分组比赛记分
小程序二维码

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

小夜