前言¶

在 Agent 里做「文字 → 视频」，常见路径是先文生图、再图生视频，中间要管两张图的提示词对齐和文件传递。若你只需要从一句描述直接得到 MP4，并希望走腾讯云已开放的混元生视频接口，可以把生成逻辑封装成 Skill，由 Agent 按文档调脚本、回传本地路径。

下面介绍 SkillHub 社区技能 @user_0d760f1d/hunyuan-text-to-video（版本 1.0.0）：基于腾讯云 HunyuanVideo 1.5，调用 SubmitHunyuanToVideoJob 做纯文生视频（T2V），不经过中间图片步骤。

这是什么¶

• 定位：基于腾讯云混元生视频 API 的直接文生视频工具；简介为「一句话生成视频，无需中间图片步骤」。
• 形态：通用 SKILL.md 技能包，内含 scripts/generate.py，由 Agent 读取说明后执行 uv run 调用。
• 来源：SkillHub 社区（community），发布者 user_0d760f1d，分类 design-media；页面标注 requires_api_key=true，需自备腾讯云 SecretId / SecretKey。
• SkillHub 页面：hunyuan-text-to-video；API 入口：https://api.skillhub.cn/user_0d760f1d/hunyuan-text-to-video。

核心功能¶

经 Skill 包内 SKILL.md 核对，当前能力包括：

1. 纯 T2V：不传 Image 时为文生视频模式，模型为 HunyuanVideo 1.5。
2. 命令行生成：通过 generate.py 提交任务、轮询 DescribeHunyuanToVideoJob，完成后将 MP4 落到当前工作目录，并打印 VIDEO_READY:/path/to/file.mp4。
3. 提示词与输出：--prompt 最多 200 个 UTF-8 字符（超长自动截断）；默认分辨率 720p；可选 --logo-add 0 去掉水印。
4. 凭据方式：支持 --secret-id / --secret-key，或环境变量 TENCENT_SECRET_ID、TENCENT_SECRET_KEY。
5. Agent 侧约定：生成后不要尝试读取视频二进制内容，应告知用户路径并可调用 open_result_view 展示。

底层 SDK 包名为 tencentcloud-sdk-python-vclm，地域示例为 ap-guangzhou（以 Skill 文档为准）。

安装与启用¶

前置：腾讯云¶

1. 在 混元生视频控制台 开通服务（免费额度或后付费）。
2. 在 CAM 控制台 获取 SecretId、SecretKey。

安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行完整安装：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装说明全文见：https://skillhub.cn/install/skillhub.md。

安装本 Skill¶

官方页面给出的坐标为 @user_0d760f1d/hunyuan-text-to-video。安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

skillhub install @user_0d760f1d/hunyuan-text-to-video --dir <你的 Agent skills 目录>

常见路径（来自 SkillHub 安装文档）：

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

也可在对话中让 AI 按 skillhub.md 安装同一坐标。安装后需按你所用客户端的要求重启或刷新，使技能被加载。

典型用法¶

以下命令来自 Skill 内 SKILL.md：{baseDir} 表示该 Skill 安装后的根目录（含 scripts/generate.py），请替换为实际绝对路径；不要先 cd 进 skill 目录再跑。

基本文生视频：

uv run {baseDir}/scripts/generate.py --prompt "一只小狗在海边玩耍，写实摄影风格"

指定输出文件名：

uv run {baseDir}/scripts/generate.py --prompt "一只小狗在海边玩耍，写实摄影风格" --filename my-video.mp4

关闭水印：

uv run {baseDir}/scripts/generate.py --prompt "一只小狗在海边玩耍，写实摄影风格" --logo-add 0

通过环境变量传入凭据：

TENCENT_SECRET_ID=xxx TENCENT_SECRET_KEY=yyy uv run {baseDir}/scripts/generate.py --prompt "一只小狗在海边玩耍，写实摄影风格"

Agent 推荐流程：执行脚本直至出现 VIDEO_READY: → 把路径告诉用户 → 按需 open_result_view。

适用场景与注意¶

适合谁

• 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，希望用自然语言触发「写提示词 + 调云 API + 落盘 MP4」。
• 接受腾讯云混元生视频的计费与合规要求，并能在 CAM 中管理 API 密钥。

限制与注意

SkillHub 抓取数据（截至编写时）：评分 100000，下载 740，安装 27；与页面展示可能随时间变化，以 SkillHub 为准。

结尾¶

hunyuan-text-to-video 把腾讯云 HunyuanVideo 1.5 的文生视频流程收成一份 SKILL.md 和可执行脚本，适合在 Agent 里用一句话描述直接出片，而不用自建图生视频中间层。开通混元生视频、配置 CAM 密钥后，按 SkillHub 坐标安装到对应 skills 目录即可使用。

• SkillHub：https://www.skillhub.cn/skills/user_0d760f1d/hunyuan-text-to-video
• 官方 API 页：https://api.skillhub.cn/user_0d760f1d/hunyuan-text-to-video