视频生成器

技能文档

---
name: video-generator-v3
title: 视频生成器
category: 内容创作
description: 基于云端视频生成 API 生成视频，支持纯文本生成视频和图生视频，可自定义时长、相机固定与水印，任务异步处理并自动下载成片。当用户要求生成视频、文生视频、图生视频、让图片动起来时触发。触发词：生成视频、文生视频、图生视频、AI视频。
---

# 视频生成器

使用云端视频生成 API（火山引擎方舟）生成视频，支持纯文本生成和图生视频，异步任务处理。

## 技能工作流

按以下顺序执行：

### 步骤1：配置密钥与模型

首次使用前，在技能目录创建 `config.json`：

```json
{
  "api_key": "你的API Key",
  "model": "你的模型ID"
}
```

- **api_key**（必需）：访问火山引擎控制台 <https://console.volcengine.com/>，在 API Key 管理中创建或获取。
- **model**（必需）：在模型服务中开通视频生成模型后获得的推理接入点 ID（形如 `ep-xxxxxxxx`）。

### 步骤2：提交生成任务

```bash
python scripts/generate_video.py "提示词" --image "https://example.com/image.jpg" --duration 5
```

脚本调用 API 创建视频生成任务，立即返回任务 ID。

### 步骤3：等待任务完成

任务为异步处理，脚本自动轮询任务状态，通常需要几分钟；期间保持网络可用。

### 步骤4：下载视频

任务完成后脚本自动把 MP4 视频下载到指定位置（默认桌面路径），并回显保存路径。

## 使用方法

### 基本用法（仅文本生成）

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

### 图生视频（需要参考图片）

```bash
python scripts/generate_video.py "无人机穿越障碍" --image "https://example.com/reference.jpg"
```

### 完整参数

```bash
python scripts/generate_video.py "提示词" \
  --image "https://example.com/image.jpg" \
  --duration 5 \
  --output "~/Desktop/视频.mp4" \
  --camera-fixed False \
  --watermark True
```

### 参数说明

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

## 注意事项

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

## 错误处理

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

使用说明

# 视频生成器

基于云端视频生成 API 的视频生成工具：纯文本生成视频、图生视频，可自定义时长与水印。

## 使用

首次使用前，在技能目录创建 `config.json`（API Key 与模型接入点从火山引擎控制台获取）：

```json
{
  "api_key": "你的API Key",
  "model": "你的模型ID"
}
```

```bash
# 纯文本生成
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落"
# 图生视频
python scripts/generate_video.py "无人机穿越障碍" --image "https://example.com/ref.jpg"
```

## 工作原理

脚本调用视频生成 API 创建异步任务，轮询任务状态直到生成完成，再自动把 MP4 成片
下载到指定位置（默认桌面）。支持 `--duration` 时长、`--camera-fixed` 相机固定、
`--watermark` 水印等参数。

如何安装此技能？

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