前言¶
做短视频或动效预览时，常见路径是：在即梦网页里上传首帧、写提示词、等任务完成，再把成片拉回本地或脚本流水线。若你已经在 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。
