前言¶

做產品演示、短視頻素材或動效預覽時，常見路徑是單獨打開某個圖生視頻控制台，上傳圖片、填提示詞、等任務完成後再把鏈接拷回工作流。若你已經在 Cursor、Claude Code 等環境裏用 Skill 驅動任務，更希望 Agent 能直接根據本地或 URL 圖片發起生成，並把結果以結構化 JSON 返回。

下面介紹 SkillHub 上的 viduq2 i2v（座標 @user_f95f21b8/dlazy-viduq2-i2v）。它把 dLazy 提供的 Vidu Q2 圖生視頻能力封裝成標準 SKILL.md，由 Agent 調用 @dlazy/cli 完成請求；與自行拼 HTTP 相比，參數、鑑權與輸出格式已在技能文檔中約定。

這是什麼¶

viduq2 i2v 的定位是：使用 Vidu Q2 圖生視頻模型，將靜態圖片轉化爲動態視頻（英文簡介：Convert static images into dynamic videos using Vidu Q2 image-to-video model.）。

• 發佈渠道：SkillHub 社區技能（source: community），頁面發佈者爲 user_f95f21b8，當前版本 1.0.9，分類 design-media。
• 底層實現：技能本身是 dLazy 託管 API 的薄封裝；CLI 由 dlazyai 維護，源碼見 github.com/dlazyai/cli，推理與媒資經 api.dlazy.com、files.dlazy.com。
• 前置條件：SkillHub 標籤標明 requires_api_key=true，需配置 dLazy API Key 後方可調用。

核心功能¶

結合技能文檔（dlazy-viduq2-i2v v1.0.9），已覈實的能力包括：

1. 圖生視頻：通過子命令 dlazy viduq2-i2v 調用，對應模型標識 vidu-i2v-viduq2。
2. 兩種生成模式（--generation_mode）：默認 components；可選 frames（首幀/尾幀模式）。
3. 輸入：components 模式下可用 --images（本地路徑或 URL，最多 10 張）、--subjects（最多 7 個）；frames 模式下用 --firstFrame、--lastFrame。
4. 可控參數：提示詞 --prompt、時長 2–10 秒、分辨率 540p/720p/1080p、畫幅比例、是否帶音頻、水印等；支持 --dry-run 預估費用、--no-wait 異步任務與 dlazy status 輪詢。
5. Agent 觸發詞：如 vidu q2、image to video（中文技能頁另有「圖生視頻」「圖片變視頻」等表述）。

技能不替代賬號與計費：請求走 dLazy 雲服務，餘額不足或 Key 無效時 CLI 會返回文檔中列明的錯誤碼。

安裝與啓用¶

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

1. 通過 SkillHub 安裝技能¶

官方頁面給出的方式是讓 Agent 按 SkillHub 安裝說明 安裝座標 @user_f95f21b8/dlazy-viduq2-i2v。若已安裝 skillhub CLI，可將技能裝到當前環境識別的目錄（必須使用 --dir，否則默認 ./skills/ 可能不被 Agent 加載）：

skillhub install @user_f95f21b8/dlazy-viduq2-i2v --dir <你的 Agent skills 目錄>

常見路徑示例（來自 SkillHub 安裝文檔）：

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

安裝後按你所用客戶端要求重啓或刷新技能列表。

2. 安裝 dLazy CLI¶

技能元數據固定 CLI 版本 1.0.9，需要本機具備 npm / npx：

npm install -g @dlazy/cli@1.0.9

或不全局安裝、按次調用：

npx @dlazy/cli@1.0.9 <子命令>

3. 配置 API Key¶

dlazy auth set YOUR_API_KEY

Key 寫入 ~/.dlazy/config.json（Windows 爲 %USERPROFILE%\.dlazy\config.json），也可通過環境變量 DLAZY_API_KEY 傳入。Key 在 dlazy.com 控制台 API Key 頁 獲取。

典型用法¶

Agent 側應按技能說明執行 dlazy viduq2-i2v。先查看完整參數：

dlazy viduq2-i2v -h

技能文檔中的示例（與 -h 列出的 --images 命名並存，以你本機 -h 爲準）：

# 基礎：本地圖片 + 提示詞
dlazy viduq2-i2v --prompt 'prompt text' --image '/path/to/image.png'

# 使用已託管的圖片 URL
dlazy viduq2-i2v --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'

components 模式下典型組合還包括 --duration、--resolution、--aspectRatio 等；異步場景可加 --no-wait，再用 dlazy status <generateId> --wait 等待完成。

成功時 CLI 返回 JSON，result.tool 爲 viduq2-i2v，outputs 中含 files.dlazy.com 上的結果 URL。本地路徑會在調用前上傳到 dLazy 媒資，與直接使用雲端圖生視頻 API 的數據流一致。

適用場景與注意¶

適合誰

• 已在 Agent 工作流裏處理圖片，希望同一對話內完成「靜圖 → 短視頻」的團隊或個人。
• 需要統一鑑權、參數和錯誤處理（如 unauthorized、insufficient_balance），而不是每次手寫 curl。

限制與注意

1. 依賴網絡與賬號：必須有效 dLazy API Key 與足夠餘額；餘額問題需到 Credits 設置 充值。
2. 數據出境/上傳：本地文件會傳到 files.dlazy.com，敏感素材需自行評估合規性。
3. SkillHub 指標（以抓取資料爲準）：評分 100000，下載約 1141 次；與頁面實時數字可能略有差異，以 SkillHub 爲準。
4. 版本綁定：技能與 CLI 均釘在 1.0.9，升級 CLI 前建議對照技能包內 SKILL.md 的 metadata 字段。

結尾¶

viduq2 i2v 把 Vidu Q2 圖生視頻收斂成 Agent 可調用的 Skill：SkillHub 負責分發與座標，dLazy CLI 負責鑑權與 API。若你的痛點是「在編碼環境裏少切換控制台、多留結構化結果」，可以按上文裝好技能與 CLI，用一張圖和一句 prompt 試跑 dlazy viduq2-i2v。

官方入口：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-viduq2-i2v
• API 座標鏈接：https://api.skillhub.cn/user_f95f21b8/dlazy-viduq2-i2v