前言¶
做短視頻或動效預覽時，常見路徑是：在即夢網頁裏上傳首幀、寫提示詞、等任務完成，再把成片拉回本地或腳本流水線。若你已經在 Cursor、Claude Code 等環境裏用 Skill 驅動 Agent，更希望把「一張首幀 + 一段描述」直接交給命令行，由 Agent 代爲調用雲端推理並拿回結果 URL。
下面介紹 SkillHub 上的 jimeng i2v first（座標 @user_f95f21b8/dlazy-jimeng-i2v-first，當前版本 1.0.9）。它把即夢首幀圖生視頻能力封裝成標準 SKILL.md，底層通過 dLazy CLI 訪問託管 API，適合需要 API Key、可腳本化的圖生視頻場景。
這是什麼¶
jimeng i2v first 的定位是：基於單張首幀圖片和提示詞，使用 Jimeng（即夢）生成動態視頻。
- 發佈渠道：SkillHub 社區來源（
community），分類爲design-media，發佈者爲user_f95f21b8。 - 技能維護與 CLI：技能元數據標明維護者爲 dlazyai，CLI 源碼在 github.com/dlazyai/cli，npm 包爲
@dlazy/cli（技能內固定版本 1.0.9）。 - 官方頁面：SkillHub 技能頁；API 入口爲
https://api.skillhub.cn/user_f95f21b8/dlazy-jimeng-i2v-first。 - 標籤：
requires_api_key=true，使用前需配置 dLazy API Key。
簡介原文：Generate dynamic videos based on a single first frame image and prompts using Jimeng.
核心功能¶
結合技能包 SKILL.md / SKILL-cn.md 與 SkillHub 頁面，可覈實的能力如下。
- 首幀圖生視頻：提供首幀圖像（本地路徑或 URL）與
--prompt，調用子命令dlazy jimeng-i2v-first；後端模型標識爲jimeng-i2v-first-v30。 - 時長可選：
--duration支持 5 或 10 秒，默認 5 秒。 - 成本與異步：
--dry-run可打印請求載荷與費用估算而不真正調用 API；--no-wait返回generateId後可用dlazy status <generateId> --wait輪詢；默認最長等待 1800 秒（--timeout可改）。 - 管道參數：各 flag 支持
-、@N、@stdin等管道引用（詳見dlazy --help）。 - Agent 觸發詞（技能內列出）：如
jimeng image to video、first frame to video、image to video；中文技能文檔中還有「即夢圖生視頻」「首幀生成視頻」「圖生視頻」等表述。
調用鏈路上，提示詞與參數發往 api.dlazy.com；本地圖片由 CLI 上傳至 files.dlazy.com；生成結果 URL 同樣託管在 files.dlazy.com。
安裝與啓用¶
安裝分兩層：先把 Skill 裝進當前 Agent 的 skills 目錄，再確保本機有 dLazy CLI 與 API Key。
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝文檔 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時可執行文檔中的安裝腳本（完整安裝或 --cli-only 僅 CLI）。
2. 安裝 jimeng i2v first 技能¶
SkillHub 頁面給出的安裝說明爲：根據 https://skillhub.cn/install/skillhub.md，安裝 @user_f95f21b8/dlazy-jimeng-i2v-first。
實際操作時需用 --dir 指向當前 Agent 正在使用的 skills 目錄，否則默認落到 ./skills/ 可能不會被識別。文檔中列出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（將 <skills 目錄> 換成你的環境路徑）：
skillhub install @user_f95f21b8/dlazy-jimeng-i2v-first --dir <skills 目錄>
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使技能被加載。
3. 安裝 dLazy CLI¶
技能 metadata 要求本機具備 npm / npx，並固定 CLI 版本：
npm install -g @dlazy/cli@1.0.9
或不全局安裝、按次調用：
npx @dlazy/cli@1.0.9 <command>
4. 配置 API Key¶
dlazy auth set YOUR_API_KEY
密鑰寫入 ~/.dlazy/config.json（Windows 爲 %USERPROFILE%\.dlazy\config.json），也可通過環境變量 DLAZY_API_KEY 按次傳入。Key 在 dlazy.com/dashboard/organization/api-key 獲取。
典型用法¶
Agent 側應按技能說明執行 dlazy jimeng-i2v-first。先查看幫助：
dlazy jimeng-i2v-first -h
主要參數（與 -h 一致）：
--prompt：提示詞（必填）--firstFrame：首幀圖，URL 或本地路徑--duration：5或10（秒）
技能文檔中的示例命令使用 --image 傳圖，與幫助裏的 --firstFrame 字段名並存；若某條示例報錯，可先對照 -h 中的參數名調整。
基礎示例（摘自技能 Command Examples）：
dlazy jimeng-i2v-first --prompt 'prompt text' --image '/path/to/image.png'
使用已上傳圖片 URL 的示例：
dlazy jimeng-i2v-first --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'
指定 10 秒時長、先估算費用：
dlazy jimeng-i2v-first --prompt '鏡頭緩慢推進，光影變化' --firstFrame '/path/to/frame.png' --duration 10 --dry-run
成功時 CLI 返回 JSON，result.tool 爲 jimeng-i2v-first，outputs 中含 files.dlazy.com 上的資源 URL。
適用場景與注意¶
適合誰
- 已有 dLazy 賬號與餘額，希望在 Agent 對話或自動化腳本里完成「首幀 + 文案 → 短視頻」。
- 需要與 dLazy 生態裏其他 Jimeng 相關技能（如同發佈者的圖生圖、數字人等）共用同一套 CLI 與 API Key。
限制與注意
- 依賴網絡與第三方服務：推理與媒資均在 dLazy 雲端，需接受數據上傳與服務條款（見 dlazy.com）。
- 計費：非
dry-run調用會消耗組織額度；insufficient_balance時需到控制台充值（技能文檔指向 credits 設置頁）。 - 鑑權失敗：
unauthorized表示 Key 缺失或無效，需重新dlazy auth set或檢查DLAZY_API_KEY。 - SkillHub 指標（抓取資料）：評分 100000，下載 1043；安裝技能後仍需自行配置 CLI 與 Key，頁面上的「安裝」計數與本地是否可用無必然對應關係。
- 安全與合規：後端可能因策略拒絕提示詞（文檔示例提及 safety policy）；生產環境建議先用
--dry-run確認參數與費用。
結尾¶
jimeng i2v first 把即夢「單首幀 + 提示詞」圖生視頻收斂成 Agent 可讀的 Skill 與一條 dlazy jimeng-i2v-first 命令，適合已使用 SkillHub 與 dLazy CLI 的開發者。技能詳情與安裝座標見 SkillHub 官方頁，API 登記地址爲 https://api.skillhub.cn/user_f95f21b8/dlazy-jimeng-i2v-first。
