前言¶
在智能体里做「文生视频」,常见做法是反复查即梦(Dreamina)文档、自己拼 dreamina 子命令和轮询逻辑。视频任务比文生图慢,参数(时长、分辨率、模型版本)也容易填错,提交后还要查积分、查任务状态、处理会话。下面介绍 SkillHub 上的社区 Skill「即梦-文生视频 CLI 技能」,它把上述流程写成 Agent 可遵循的 SKILL.md 指引,在用户提到 dreamina text2video、命令行生视频 或要提交/执行视频提示词时,由智能体按规范调用 CLI。
这是什么¶
即梦-文生视频 CLI 技能,让你的智能体通过 即梦 CLI 生成视频(坐标 @user_c1d16043/jimeng-cli-text2video,当前版本 v1.0.3,来源 community,发布者 user_c1d16043)是一份面向开发场景的 Agent Skill(分类 dev-programming)。它不替代 dreamina 可执行文件本身,而是在智能体侧提供:如何通过 dreamina CLI 对接即梦 Seedance 2.0 文生视频、如何选参、如何轮询与排错。
SkillHub 页面标注作者为 Loong10K;技能标签为 requires_api_key=false(指安装该 Skill 本身不额外要求 API Key 类配置,具体以你本机 dreamina CLI 的登录与鉴权为准)。
核心功能¶
依据 SkillHub 简介与已抓取说明,该 Skill 覆盖的能力包括:
- 文生视频执行指引:面向即梦 Seedance 2.0,指导通过命令行完成文本生成视频(触发词包括
dreamina text2video、生成视频、提交或执行视频提示词等)。 - 视频专用参数说明:
duration、video_resolution、model_version等选项的参考;CLI 侧视频默认使用 720P 分辨率,时长支持 4–15 秒。 - 模型选择说明:Seedance 2.0 在速度与生成分辨质量之间的取舍说明(供智能体帮用户选型)。
- 标准工作流:文档中归纳 4 种常见视频执行流程(具体步骤以安装后的 SKILL.md 为准)。
- 异步任务与运维:建议轮询时间比图片更长(60–180 秒);并覆盖积分查询、任务查询、session 管理,以及基于官方文档的错误处理模式。
用户线索中的英文简介还提到通过 dreamina text2video 进行提交、轮询与故障排查,以及会话与异步终态状态——与上述「任务查询 / session / 轮询」表述一致;未在 SkillHub 公开简介中出现的 CLI 小版本号或比例校验细节,本文不展开。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 skillhub:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 官方安装文档执行完整安装(推荐)或仅 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明:在受限网络环境下,安装脚本需要允许访问外网。
2. 安装本 Skill¶
SkillHub 页面给出的安装提示为:根据 SkillHub 安装说明 安装坐标 @user_c1d16043/jimeng-cli-text2video。
命令行方式示例(--dir 必须指向当前 Agent 实际使用的 skills 目录,否则可能装到默认 ./skills/ 而未被加载):
skillhub install @user_c1d16043/jimeng-cli-text2video --dir <你的 Agent skills 目录>
常见目录(来自 SkillHub 安装文档,按你使用的客户端选用):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装完成后,按你所用 Agent 的要求重启或刷新技能列表,使 SKILL.md 生效。
3. 前置依赖¶
本 Skill 假定你已在环境中配置并可调用 dreamina CLI(即梦命令行)。视频生成、登录与计费以 CLI 与即梦官方文档为准;Skill 负责让智能体「按正确流程」使用 text2video 相关能力,而不是代替 CLI 安装。
典型用法¶
安装后,智能体在匹配场景时会读取 Skill 内的流程与参数表。从公开简介可复现的使用模式如下(具体子命令与标志位以 SKILL.md 与官方 CLI 文档为准):
- 提交视频任务:用户给出已审核的文本提示词,智能体按 Skill 选择 Seedance 2.0 与
duration(4–15 秒)、video_resolution(720P)、model_version等,通过dreamina text2video相关命令提交。 - 轮询结果:视频生成耗时通常长于图片;按 Skill 建议,轮询间隔或总等待宜落在 60–180 秒量级,并查询异步任务状态直至成功或明确失败。
- 辅助操作:需要时查询积分、按任务 ID 查询进度,或在多轮对话中维护 session,避免重复登录或参数丢失。
- 排错:参数不合法(如时长超出 4–15 秒)、分辨率不符合要求、或任务终态异常时,按 Skill 中的错误处理模式对照官方说明调整。
你无需手写上述 checklist;在对话中直接说明「用命令行给即梦生成一段 N 秒视频」或引用 dreamina text2video,Agent 应自动加载本 Skill。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端,希望智能体稳定走 CLI 文生视频 而非临时猜命令的开发者。
- 需要即梦 Seedance 2.0、固定 720P 与 4–15 秒时长约束下的批量或脚本化尝试(由 Agent 代劳命令拼装与轮询)。
限制与注意
- 视频任务慢:务必按 Skill 建议拉长轮询,避免过早判定失败。
- Skill 版本为 v1.0.3,SkillHub 统计(以页面与抓取为准):评分 100000,下载 4219,安装计数 0——安装数可能未回传,以你本机
--dir是否装对为准。 - 分类为 dev-programming,侧重开发与自动化,不承诺替代即梦产品内的全部 UI 能力。
- 公开资料未列出各客户端差异配置时,仅按 SkillHub 通用
--dir方式安装即可。
结尾¶
若你希望智能体在提到即梦命令行生视频时,自动覆盖 Seedance 2.0 参数、轮询时长、任务与会话管理,可在 SkillHub 安装 @user_c1d16043/jimeng-cli-text2video。官方入口:SkillHub 技能页,API 坐标页:https://api.skillhub.cn/user_c1d16043/jimeng-cli-text2video。