SD1.5pro 视频生成技能
功能
使用火山引擎的 SD1.5pro API 生成视频，支持纯文本生成和图生视频。
首次使用配置
1. 创建配置文件
在技能目录中创建 config.json 文件：
{
"api_key": "你的火山引擎API Key",
"model": "你的模型ID（如：ep-20260313005600-p8s6m）"
}
2. 配置说明
- api_key: 火山引擎API Key（必需）
- model: 模型ID（必需），默认使用
ep-20260313005600-p8s6m
3. 获取API Key和模型ID
- 访问火山引擎控制台：https://console.volcengine.com/
- 在API Key管理中创建或获取API Key
- 在模型服务中找到SD1.5pro模型的ID
使用方法
基本用法（仅文本生成）
python scripts/generate_video.py "提示词"
图生视频（需要参考图片）
python scripts/generate_video.py "提示词" --image "https://example.com/image.jpg"
指定输出路径
python scripts/generate_video.py "提示词" --output "C:\Users\Desktop\视频.mp4"
完整参数
python scripts/generate_video.py "提示词" \
--image "https://example.com/image.jpg" \
--duration 5 \
--output "C:\Users\Desktop\视频.mp4" \
--camera-fixed False \
--watermark True
参数说明
| 参数 | 类型 | 必需 | 默认值 | 说明 |
|---|---|---|---|---|
prompt |
字符串 | 是 | - | 文本提示词 |
--image |
字符串 | 否 | 无 | 参考图片URL（图生视频） |
--duration |
整数 | 否 | 5 | 视频时长（秒） |
--output |
字符串 | 否 | 桌面 | 输出文件路径 |
--camera-fixed |
布尔 | 否 | False | 相机是否固定 |
--watermark |
布尔 | 否 | True | 是否添加水印 |
工作流程
- 创建任务: 调用API创建视频生成任务
- 异步处理: 轮询任务状态，等待生成完成
- 下载视频: 自动下载生成的视频到指定位置
示例
示例1：纯文本生成
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落"
示例2：图生视频
python scripts/generate_video.py "无人机穿越障碍" \
--image "https://example.com/reference.jpg"
示例3：自定义参数
python scripts/generate_video.py "美丽风景" \
--duration 10 \
--output "C:\Videos\风景.mp4" \
--watermark False
注意事项
- 首次使用前必须配置
config.json文件 - 视频生成是异步的，可能需要几分钟
- 建议使用桌面路径保存视频
- 支持MP4格式输出
- 默认视频时长为5秒，最大时长取决于模型限制
错误处理
如果遇到以下错误：
- 配置文件不存在: 创建
config.json文件并配置API Key和模型ID - API Key无效: 检查API Key是否正确
- 模型ID错误: 确认模型ID是否有效
- 网络错误: 检查网络连接和防火墙设置
API文档
- 火山引擎控制台: https://console.volcengine.com/
- API文档: https://www.volcengine.com/docs/
