前言¶
在 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 與官方簡介,可按命令行參數組合使用。
-
多模態參考(
generation_mode=components,默認)
---images:最多 9 張參考圖(URL 或本地路徑)
---videos:最多 3 段參考視頻
---audios:最多 3 段參考音頻 -
首尾幀模式(
generation_mode=frames)
---firstFrame、--lastFrame:首幀與尾幀圖像,用於控制起止畫面。 -
文生視頻
- 通過必填的--prompt描述畫面;可與上述模式配合(首尾幀模式下不傳 images/videos/audios 參考項)。 -
輸出與畫幅
- 分辨率:480p/720p(默認) /1080p
- 比例:21:9、16:9(默認)、4:3、1:1、3:4、9:16
- 時長:4–15 秒(默認 5 秒)
---generate_audio:是否生成音頻(默認true) -
任務控制
---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)行爲一致。 - 需要多參考圖/音視頻、首尾幀或可調分辨率與畫幅的短視頻生成流水線。
限制與注意
- 付費與密鑰:依賴 dLazy 賬戶餘額;
insufficient_balance時需到控制台充值;未配置 Key 會返回unauthorized。 - 數據出境:提示詞與上傳的本地媒體會進入 dLazy 雲端,需符合你方數據合規要求。
- 依賴環境:需 Node 生態下的
npm/npx;Skill 爲社區發佈,與 ByteDance 官方無 SkillHub「作者認證」綁定,使用前可在 github.com/dlazyai/cli 審閱 CLI 源碼。 - 安全掃描: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