SD1.5pro视频生成

技能文档

---
name: video-generator-seedance
description: 使用火山引擎 SD1.5pro API 生成视频。支持文本到视频和图生视频，异步处理任务。当用户需要文生视频、图生视频、AI视频生成，提到 SD1.5pro 或输入视频提示词生成短视频时触发。
title: SD1.5pro视频生成
category: 内容创作
---

# SD1.5pro 视频生成技能

## 功能
使用火山引擎的 SD1.5pro API 生成视频，支持纯文本生成和图生视频。

## 首次使用配置

### 1. 创建配置文件

在技能目录中创建 `config.json` 文件：

```json
{
  "api_key": "你的火山引擎API Key",
  "model": "你的模型ID（如：ep-20260313005600-p8s6m）"
}
```

### 2. 配置说明

- **api_key**: 火山引擎API Key（必需）
- **model**: 模型ID（必需），默认使用 `ep-20260313005600-p8s6m`

### 3. 获取API Key和模型ID

1. 访问火山引擎控制台：https://console.volcengine.com/
2. 在API Key管理中创建或获取API Key
3. 在模型服务中找到SD1.5pro模型的ID

## 使用方法

### 基本用法（仅文本生成）
```bash
python scripts/generate_video.py "提示词"
```

### 图生视频（需要参考图片）
```bash
python scripts/generate_video.py "提示词" --image "https://example.com/image.jpg"
```

### 指定输出路径
```bash
python scripts/generate_video.py "提示词" --output "C:\Users\Desktop\视频.mp4"
```

### 完整参数
```bash
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 | 是否添加水印 |

## 技能工作流

### 步骤1：加载配置并创建任务

脚本从技能目录的 `config.json` 读取 API Key 与模型 ID，向火山引擎 API 提交视频生成任务，任务参数（时长、相机固定、水印）拼入提示词文本中传递。

### 步骤2：轮询任务状态

任务提交后返回任务 ID，脚本按固定间隔轮询任务状态，直到状态变为 `succeeded` 或超过最大等待时间（默认 300 秒）。

### 步骤3：提取视频 URL 并下载

任务完成后从响应中提取视频 URL，自动将 MP4 文件下载到指定输出路径（默认保存到用户桌面）。

## 示例

### 示例1：纯文本生成
```bash
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落"
```

### 示例2：图生视频
```bash
python scripts/generate_video.py "无人机穿越障碍" \
  --image "https://example.com/reference.jpg"
```

### 示例3：自定义参数
```bash
python scripts/generate_video.py "美丽风景" \
  --duration 10 \
  --output "C:\Videos\风景.mp4" \
  --watermark False
```

## 注意事项

- 首次使用前必须配置 `config.json` 文件
- 视频生成是异步的，可能需要几分钟
- 建议使用桌面路径保存视频
- 支持MP4格式输出
- 默认视频时长为5秒，最大时长取决于模型限制

## 错误处理

如果遇到以下错误：

1. **配置文件不存在**: 创建 `config.json` 文件并配置API Key和模型ID
2. **API Key无效**: 检查API Key是否正确
3. **模型ID错误**: 确认模型ID是否有效
4. **网络错误**: 检查网络连接和防火墙设置

## API文档

- 火山引擎控制台: https://console.volcengine.com/
- API文档: https://www.volcengine.com/docs/

使用说明

# SD1.5pro视频生成

使用火山引擎 SD1.5pro API 生成视频，支持文本到视频与图生视频，异步任务处理。

## 适用场景

- 纯文本提示词生成短视频
- 参考图生成视频（图生视频）

## 最简用法

```bash
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落"
python scripts/generate_video.py "无人机穿越障碍" --image "https://example.com/ref.jpg" --duration 5
```

## 说明

- 首次使用在技能目录创建 config.json，填入火山引擎 API Key 与模型 ID
- 视频生成异步执行，通常需几分钟，完成后自动下载到指定位置

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。