with one click
with one click
| name | tencentcloud-video-effects |
| description | 通过上传图片和选择特效模板,生成一段特效视频,将静态图像转化为充满活力、动感、有趣的视频画面。 |
本 Skill 提供视频特效能力,识别传入图片中人体的完整轮廓,进行抠像:
| 场景 | API | 脚本 | 图片大小限制 | 返回方式 |
|---|---|---|---|---|
| 视频特效 | TemplateToVideo | main.py | 10MB | 异步 |
本 Skill 需要腾讯云 API 密钥才能正常工作。
Linux / macOS:
export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"
如需持久化:
echo 'export TENCENTCLOUD_SECRET_ID="你的SecretId"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="你的SecretKey"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell):
$env:TENCENTCLOUD_SECRET_ID = "你的SecretId"
$env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey"
⚠️ 安全提示:切勿将密钥硬编码在代码中。
⚠️ 本节是 Agent(AI 模型)的核心执行规范。当用户提供图片并请求视频特效时,Agent 必须严格按照以下步骤自主执行,无需询问用户确认。
main.pypython3 <SKILL_DIR>/scripts/main.py "<TEMPLATE_NAME>" "<PIC_INPUT>" [可选参数]
必填参数:
| 参数 | 说明 | 示例 |
|---|---|---|
<TEMPLATE_NAME> | 特效模板名称 | hug |
<PIC_INPUT> | 输入图片 URL 或本地文件路径(≤10MB,支持 png/jpg/jpeg/webp/bmp/tiff) | https://example.com/human.png 或 /path/to/image.png |
可选参数:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
--logo-add | int | 1 | 是否添加 AI 生成标识:1=添加, 0=不添加 |
--resolution | string | 360p | 视频输出分辨率,如 360p、720p、1080p |
--bgm | flag | 不添加 | 添加此参数则为生成视频添加背景音乐 |
--poll-interval | int | 5 | 轮询任务状态的间隔秒数 |
--max-poll-time | int | 600 | 最大轮询等待时间(秒),超时则报错退出 |
--no-poll | flag | 关闭 | 添加此参数则仅提交任务并返回 JobId,不轮询结果 |
输出示例:
{
"ResultVideoUrl": "https://bda-segment-mini-1258344699.cos.ap-guangzhou.myqcloud.com/Image/1251755623/9e73b301-ad1b-4586-837b-b767e73c4bf2"
}
基本调用(使用默认参数):
python3 /path/to/scripts/main.py hug "https://example.com/human.png"
指定分辨率和背景音乐:
python3 /path/to/scripts/main.py hug "https://example.com/human.png" --resolution 720p --bgm
去除 AI 标识 + 高分辨率:
python3 /path/to/scripts/main.py hug /path/to/local/image.jpg --logo-add 0 --resolution 1080p
仅提交任务,不等待结果:
python3 /path/to/scripts/main.py hug "https://example.com/human.png" --no-poll
自定义轮询策略:
python3 /path/to/scripts/main.py hug "https://example.com/human.png" --poll-interval 10 --max-poll-time 300
详细的引擎类型、参数说明、错误码等信息请参阅 references/ 目录下的文档:
scripts/main.py — 视频特效脚本tencentcloud-sdk-python(腾讯云 SDK,main.py 使用)安装依赖(可选 - 脚本会自动安装):
pip install tencentcloud-sdk-python requests
腾讯云混元生图 3.0,文生图 / 图生图,智能生成贴合描述的图片。Tencent Cloud Hunyuan Image Generation 3.0, text-to-image / image-to-image, intelligently generates images matching the description.
输入文字或图片,通过混元生3D 3.0、3.1 模型,生成更高精度以及更高质量的3D 模型,支持文生3D,图生3D,多视图生3D,单几何生成(白模),草图生3D,智能拓扑生3D功能。
图片人脸融合(专业版)为同步接口,支持自定义美颜、人脸增强、牙齿增强、拉脸等参数,最高支持8K分辨率,有多个模型类型供选择。
通过提取两张人脸核心特征并实现自然融合,支持多种风格适配,提升创意互动性和内容传播力,广泛应用于创意营销、娱乐互动和社交分享场景。
Binary classification-based human portrait segmentation for complete body contour recognition and image matting.