技能介绍

要解决的问题

hunyuan-text-to-video 解决的是从文字描述直接生成 MP4 视频的调用问题。工程师不需要先做文生图、再拼接镜头或视频合成，而是把 prompt 交给腾讯云混元生视频 API，由 HunyuanVideo 1.5 模型完成端到端文本到视频生成。适合快速验证创意、生成示例片段，或为 Agent 工作流接入一个可展示的视频结果节点。

技能如何工作

技能通过腾讯云 SubmitHunyuanToVideoJob 提交任务，并用 DescribeHunyuanToVideoJob 查询状态。核心参数包括：

--prompt：必填，最多 200 个 UTF-8 字符，超长会被截断。
--filename：可选，指定输出文件名，默认按时间戳生成 .mp4。
--video-resolution：目前仅支持 720p。
--logo-add：控制是否添加水印，0 不添加，1 添加。
--secret-id / --secret-key：也可使用 TENCENT_SECRET_ID 与 TENCENT_SECRET_KEY 环境变量传入。

运行时，技能会调用 tencentcloud-sdk-python-vclm 初始化 VclmClient，提交纯 T2V 任务，并等待状态从 WAIT、RUN 变为 DONE。完成后，视频保存为 MP4 到当前工作目录，并打印 VIDEO_READY:/path/to/file.mp4。推荐流程是直接读取该路径展示结果，而不是尝试解析视频内容。

适用边界与注意点

该技能依赖腾讯云账号凭据，使用前需要开通混元生视频服务并具备可用额度或后付费能力。ResultVideoUrl 的有效期为 24 小时，不适合把远端 URL 当作长期资源。默认并发为 1 个任务，上一个任务未完成前不宜连续提交。生成结果受 prompt 长度、720p 分辨率限制，且默认可能添加水印；如果交付给最终用户，需要显式传入 --logo-add 0。