AI视频生成

技能文档

---
name: seedance-video-gen
title: AI视频生成
category: 内容创作
description: 使用火山引擎 SD1.5pro API 生成视频，支持文本到视频和图生视频，异步任务处理并自动下载成片。当用户需要文生视频、图生视频、AI生成短视频、生成视频片段时触发。触发词：视频生成、文生视频、图生视频、AI视频。
---

# AI视频生成

使用火山引擎的 SD1.5pro API 生成视频，支持纯文本生成和图生视频：给一段提示词（可选配参考图），自动创建生成任务、轮询进度并下载成片到本地。

## 技能工作流

### 步骤1：检查配置

在技能目录确认存在 `config.json`（可从 `config.example.json` 复制修改）：

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

- **api_key**：火山引擎 API Key（必需）。访问控制台 `https://console.volcengine.com/`，在「API Key 管理」中创建或获取。
- **model**：模型 ID（必需）。在「模型服务」中找到 SD1.5pro 模型并复制其 ID。

配置缺失时不发起任务，先引导用户完成配置。

### 步骤2：收集生成参数

与用户确认提示词（必填），其余参数缺项给默认：

| 参数 | 类型 | 必需 | 默认值 | 说明 |
|------|------|------|--------|------|
| `prompt` | 字符串 | 是 | - | 文本提示词 |
| `--image` | 字符串 | 否 | 无 | 参考图片URL（图生视频） |
| `--duration` | 整数 | 否 | 5 | 视频时长（秒） |
| `--output` | 字符串 | 否 | 桌面 | 输出文件路径 |
| `--camera-fixed` | 布尔 | 否 | False | 相机是否固定 |
| `--watermark` | 布尔 | 否 | True | 是否添加水印 |
| `--config` | 字符串 | 否 | config.json | 配置文件路径 |

### 步骤3：提交任务并等待完成

运行脚本后自动完成三步：调用 API 创建任务 → 轮询任务状态等待生成 → 下载成片到指定位置。

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

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

# 自定义参数
python scripts/generate_video.py "美丽风景" \
  --duration 10 \
  --output "./风景.mp4" \
  --watermark False
```

视频生成是异步的，可能需要几分钟，期间如实向用户转述进度。

### 步骤4：交付成片

告知用户视频保存路径；建议使用绝对路径保存，输出为 MP4 格式。

## 注意事项

- 首次使用前必须配置 `config.json` 文件。
- 默认视频时长为 5 秒，最大时长取决于模型限制。
- 不同模型可能有不同的时长和分辨率限制。

## 错误处理

| 错误 | 处理方式 |
|------|----------|
| 配置文件不存在 | 从 `config.example.json` 复制创建 `config.json` 并填写 |
| 缺少 api_key | 在 `config.json` 中添加 `api_key` 字段 |
| API Key 无效 | 检查 API Key 是否正确、是否已过期 |
| 模型 ID 错误 | 确认模型 ID 是否有效、模型是否可用 |
| 网络错误 | 检查网络连接和防火墙设置 |

## API 文档

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

使用说明

# AI视频生成

使用火山引擎 SD1.5pro API 生成视频，支持文本到视频和图生视频，自动轮询任务并下载成片。

## 使用

1. 复制 `config.example.json` 为 `config.json`，填入火山引擎 API Key 与模型 ID。
2. 对 Agent 说或直接运行：

```bash
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落"

# 图生视频
python scripts/generate_video.py "无人机穿越障碍" \
  --image "https://example.com/reference.jpg" \
  --output "./demo.mp4"
```

## 工作原理

- 调用火山引擎 API 创建异步生成任务，轮询状态直到完成；
- 自动下载 MP4 到指定路径，默认 5 秒时长、可调水印与镜头固定。

如何安装此技能？

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