anbeime/skill / skills/product-video-creator/product-video-creator
product-video-creator
Verified电商运营与内容创作者在制作商品宣传、带货及社媒营销视频时,使用此多智能体协同流水线,一键自动完成卖点文案、故事分镜、场景图片、音效字幕到MP4视频合成的全流程,高效产出专业级营销视频,大幅节省制作成本与时间。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
| references/storyboard_format.md | markdown | 7.1 KB |
| references/subtitle_format.md | markdown | 10.5 KB |
| references/video_specs.md | markdown | 6.2 KB |
| scripts/video_composer.py | script | 12.3 KB |
scripts/video_composer.py
View on GitHub#!/usr/bin/env python3
"""
商品视频合成脚本
功能:将图片序列、字幕、音频合成为完整视频
"""
import os
import sys
import json
import argparse
from pathlib import Path
from typing import List, Dict
try:
from moviepy import (
VideoFileClip,
ImageSequenceClip,
AudioFileClip,
CompositeVideoClip,
TextClip,
vfx
)
import numpy as np
except ImportError as e:
print(f"错误:缺少必要的依赖包")
print(f"详细信息:{e}")
print(f"请运行:pip install moviepy pillow opencv-python")
sys.exit(1)
def load_subtitles(subtitle_file: str) -> List[Dict]:
"""
加载字幕配置文件
Args:
subtitle_file: 字幕配置文件路径
Returns:
字幕配置列表
"""
if not os.path.exists(subtitle_file):
raise FileNotFoundError(f"字幕文件不存在:{subtitle_file}")
with open(subtitle_file, 'r', encoding='utf-8') as f:
data = json.load(f)
if 'subtitles' not in data:
raise ValueError("字幕文件格式错误:缺少 'subtitles' 字段")
return data['subtitles']
def create_subtitle_clip(subtitle: Dict, video_width: int, video_height: int):
"""
创建单个字幕片段
Args:
subtitle: 字幕配置字典
video_width: 视频宽度
video_height: 视频高度
Returns:
TextClip对象
"""
text = subtitle.get('text', '')
fontsize = subtitle.get('font_size', 48)
color = subtitle.get('color', '#FFFFFF')
position = subtitle.get('position', 'bottom')
has_background = subtitle.get('background', True)
bg_color = subtitle.get('background_color', 'rgba(0,0,0,0.5)')
if not text:
return None
try:
# 创建文本片段
txt_clip = TextClip(
text,
fontsize=fontsize,
color=color,
font='SimHei', # 使用黑体,支持中文
transparent=True
)
# 设置持续时间
start_time = subtitle.get('start_time', 0)
end_time = subtitle.get('end_time', start_time + 2)
duration = end_time - start_time
txt_clip = txt_clip.set_start(start_time).set_duration(duration)
# 设置位置
if position == 'top':
txt_clip = txt_clip.set_position(('center', video_height * 0.1))
elif position == 'center':
txt_clip = txt_clip.set_position('center')
else: # bottom
txt_clip = txt_clip.set_position(('center', video_height * 0.85))
# 添加背景
if has_background:
bg_width = txt_clip.w + 40
bg_height = txt_clip.h + 20
bg_clip = TextClip(
' ',
fontsize=1,
color=bg_color,
size=(bg_width, bg_height),
transparent=True
).set_opacity(1.0)
bg_clip = bg_clip.set_start(start_time).set_duration(duration)
# 设置背景位置
if position == 'top':
bg_clip = bg_clip.set_position(('center', video_height * 0.1 - 10))
elif position == 'center':
bg_clip = bg_clip.set_position('center')
else: # bottom
bg_clip = bg_clip.set_position(('center', video_height * 0.85 - 10))
# 将文本叠加在背景上
final_clip = CompositeVideoClip([bg_clip, txt_clip])
else:
final_clip = txt_clip
return final_clip
except Exception as e:
print(f"警告:创建字幕失败 - {e}")
return None
def get_transition_duration(transition_type: str) -> float:
"""
获取转场持续时间
Args:
transition_type: 转场类型
Returns:
持续时间(秒)
"""
transition_map = {
'淡入': 0.5,
'淡出': 0.5,
'淡入淡出': 0.5,
'切': 0,
'推': 0.5,
'拉': 0.5,
'变焦': 1.0
}
return transition_map.get(transition_type, 0)
def create_video_from_images(
image_paths: List[str],
durations: List[float],
transitions: List[str],
fps: int = 24
):
"""
从图片序列创建视频
Args:
image_paths: 图片路径列表
durations: 每张图片的持续时间列表
transitions: 转场类型列表
fps: 帧率
Returns:
VideoClip对象
"""
if len(image_paths) != len(durations):
raise ValueError("图片数量和时长数量不匹配")
clips = []
current_time = 0
for i, (img_path, duration, transition) in enumerate(zip(image_paths, durations, transitions)):
# 加载图片
img_clip = ImageSequenceClip([img_path], fps=fps)
img_clip = img_clip.set_start(current_time).set_duration(duration)
# 应用转场效果
trans_duration = get_transition_duration(transition)
if transition == '淡入' and i == 0:
img_clip = img_clip.fadein(trans_duration)
elif transition == '淡出' and i == len(image_paths) - 1:
img_clip = img_clip.fadeout(trans_duration)
elif transition == '淡入淡出' and i > 0:
img_clip = img_clip.crossfadeout(trans_duration)
elif transition == '推':
# 简化的推入效果
def slide_in_effect(t):
progress = t / trans_duration if t < trans_duration else 1
return min(progress, 1)
img_clip = img_clip.set_position(lambda t: (video_width * (1 - slide_in_effect(t)), 'center'))
elif transition == '拉':
# 简化的拉出效果
def slide_out_effect(t):
progress = (duration - t) / trans_duration if t > duration - trans_duration else 1
return max(-progress, 0)
img_clip = img_clip.set_position(lambda t: (video_width * slide_out_effect(t), 'center'))
elif transition == '变焦':
# 变焦效果:缩放图片
def zoom_effect(t):
return 1 + 0.1 * np.sin(2 * np.pi * t / duration)
img_clip = img_clip.resize(lambda t: zoom_effect(t))
clips.append(img_clip)
current_time += duration - trans_duration if i < len(image_paths) - 1 else duration
# 合并所有片段
final_video = CompositeVideoClip(clips)
return final_video
def compose_video(
images: List[str],
subtitles: List[Dict],
audio_file: str,
output_file: str,
durations: List[float],
transitions: List[str],
fps: int = 24,
video_width: int = 1920,
video_height: int = 1080
):
"""
合成视频
Args:
images: 图片路径列表
subtitles: 字幕配置列表
audio_file: 音频文件路径
output_file: 输出视频文件路径
durations: 每张图片的持续时间列表
transitions: 转场类型列表
fps: 帧率
video_width: 视频宽度
video_height: 视频高度
Returns:
输出文件路径
"""
print(f"开始合成视频...")
print(f"图片数量: {len(images)}")
print(f"字幕数量: {len(subtitles)}")
print(f"帧率: {fps} fps")
print(f"分辨率: {video_width}x{video_height}")
# 验证图片是否存在
for img in images:
if not os.path.exists(img):
raise FileNotFoundError(f"图片文件不存在:{img}")
# 验证音频文件
if audio_file and not os.path.exists(audio_file):
raise FileNotFoundError(f"音频文件不存在:{audio_file}")
# 创建视频片段
print("创建视频片段...")
video_clip = create_video_from_images(images, durations, transitions, fps)
# 如果没有提供时长,根据字幕或音频计算
if not durations and subtitles:
total_duration = max([s.get('end_time', 0) for s in subtitles])
print(f"根据字幕计算总时长: {total_duration}秒")
# 平均分配每个镜头的时长
avg_duration = total_duration / len(images)
durations = [avg_duration] * len(images)
video_clip = create_video_from_images(images, durations, transitions, fps)
elif not durations:
print("警告:未提供时长信息,使用默认时长3秒")
durations = [3.0] * len(images)
video_clip = create_video_from_images(images, durations, transitions, fps)
# 添加音频
if audio_file:
print("添加音频...")
audio_clip = AudioFileClip(audio_file)
video_duration = video_clip.duration
if audio_clip.duration > video_duration:
audio_clip = audio_clip.subclip(0, video_duration)
elif audio_clip.duration < video_duration:
audio_clip = audio_clip.audio_loop(duration=video_duration)
video_clip = video_clip.set_audio(audio_clip)
# 添加字幕
if subtitles:
print(f"添加 {len(subtitles)} 条字幕...")
subtitle_clips = []
for subtitle in subtitles:
subtitle_clip = create_subtitle_clip(subtitle, video_width, video_height)
if subtitle_clip:
subtitle_clips.append(subtitle_clip)
if subtitle_clips:
video_clip = CompositeVideoClip([video_clip] + subtitle_clips)
# 调整分辨率
if video_clip.w != video_width or video_clip.h != video_height:
print(f"调整分辨率为 {video_width}x{video_height}...")
video_clip = video_clip.resize((video_width, video_height))
# 写入视频文件
print(f"正在写入视频文件: {output_file}")
video_clip.write_videofile(
output_file,
fps=fps,
codec='libx264',
audio_codec='aac',
bitrate='8000k',
preset='medium'
)
print(f"视频合成完成: {output_file}")
return output_file
def main():
parser = argparse.ArgumentParser(description='商品视频合成工具')
parser.add_argument('--images', type=str, required=True, help='图片文件列表(支持通配符)')
parser.add_argument('--subtitles', type=str, required=True, help='字幕配置文件路径(JSON格式)')
parser.add_argument('--audio', type=str, required=False, default='', help='音频文件路径')
parser.add_argument('--output', type=str, required=True, help='输出视频文件路径')
parser.add_argument('--fps', type=int, default=24, help='帧率(默认24)')
parser.add_argument('--duration', type=float, default=None, help='每个镜头的持续时间(秒)')
parser.add_argument('--width', type=int, default=1920, help='视频宽度(默认1920)')
parser.add_argument('--height', type=int, default=1080, help='视频高度(默认1080)')
args = parser.parse_args()
# 解析图片路径
image_pattern = args.images
if '*' in image_pattern:
# 使用glob匹配
from glob import glob
images = sorted(glob(image_pattern))
else:
# 直接使用
images = [image_pattern]
if not images:
print(f"错误:未找到匹配的图片: {args.images}")
sys.exit(1)
print(f"找到 {len(images)} 张图片")
# 加载字幕
subtitles = load_subtitles(args.subtitles)
# 计算每个镜头的时长
if args.duration:
durations = [args.duration] * len(images)
else:
# 从字幕中推断时长
durations = []
for i in range(len(images)):
# 找到与该镜头对应的字幕
lens_subs = [s for s in subtitles if s.get('id') == i + 1]
if lens_subs:
avg_duration = np.mean([s.get('end_time', 0) - s.get('start_time', 0) for s in lens_subs])
durations.append(avg_duration + 0.5) # 额外0.5秒缓冲
else:
durations.append(3.0) # 默认3秒
# 转场类型(默认都使用切)
transitions = ['切'] * len(images)
# 合成视频
try:
compose_video(
images=images,
subtitles=subtitles,
audio_file=args.audio if args.audio else None,
output_file=args.output,
durations=durations,
transitions=transitions,
fps=args.fps,
video_width=args.width,
video_height=args.height
)
except Exception as e:
print(f"视频合成失败: {e}")
import traceback
traceback.print_exc()
sys.exit(1)
if __name__ == '__main__':
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |