腾讯云视频特效

解决的问题

当用户提供一张含人物主体的图片，并想基于腾讯云视频特效模板生成一段短视频时，手动调用 TemplateToVideo 往往需要处理密钥、任务提交、异步轮询和结果解析。这个技能把这些步骤收敛到 main.py，让 Agent 可以直接执行脚本并返回视频特效结果。

工作方式

• 输入：图片 URL 或本地路径，限制 10MB，支持 png、jpg、jpeg、webp、bmp、tiff。
• 核心能力：识别图片中人体完整轮廓并进行抠像，再按指定特效模板生成视频。
• 常用参数：模板名（如 hug）、--resolution 控制输出分辨率、--bgm 添加背景音乐、--logo-add 控制 AI 生成标识、--poll-interval 与 --max-poll-time 控制异步任务轮询。
• 返回方式：默认异步提交并轮询任务，直到拿到结果或超时；--no-poll 可只返回任务 ID。
• 执行边界：调用失败时不应编造识别内容，而应返回清晰错误说明。

注意点

适合已开通腾讯云视频特效服务并完成 API 密钥配置的自动化流程。它不是本地离线渲染工具，也不适用于没有人体轮廓、无法匹配模板或需要纯图像编辑的场景。输出结果受模板、分辨率、任务超时和后台异步状态影响。