# Video Generation

> 视频生成工具，支持文生视频、图生视频、视频生视频任务创建、状态查询和结果下载。

- Skill: `kesepain-ke/video-generation` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add kesepain-ke/video-generation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kesepain-ke/video-generation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kesepain-ke (https://skillmd.com/u/kesepain-ke)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kesepain-ke/video-generation

---


# 视频生成 (Video Generation)

通过当前 provider 的 `video_generation` 能力创建异步视频任务。需要配置 `video_generation_model`。

## 插件路径

`plugins/video_generation/`

## 注册工具

| 工具名 | 描述 |
|--------|------|
| `video_generate` | 创建文生视频、图生视频或视频生视频任务 |
| `video_status` | 查询视频生成任务状态 |
| `video_download` | 下载已完成任务的视频结果到本地 |

## 参数

### video_generate

| 参数 | 类型 | 必需 | 默认值 | 说明 |
|------|------|------|--------|------|
| `prompt` | string | 否 | `""` | 视频描述或编辑要求 |
| `image` | string | 否 | `""` | 图片路径、URL 或 data URL，用于图生视频 |
| `video` | string | 否 | `""` | 视频路径、URL 或 data URL，用于视频生视频 |
| `duration` | integer | 否 | 0 | 可选视频时长 |
| `size` | string | 否 | `""` | 可选视频尺寸 |
| `negative_prompt` | string | 否 | `""` | 可选负向提示词 |
| `seed` | integer | 否 | 0 | 可选随机种子 |
| `model` | string | 否 | `""` | 可选模型 ID；留空使用 `provider.video_generation_model` |

### video_status

| 参数 | 类型 | 必需 | 默认值 | 说明 |
|------|------|------|--------|------|
| `job_id` | string | 是 | — | 视频任务 ID |

### video_download

| 参数 | 类型 | 必需 | 默认值 | 说明 |
|------|------|------|--------|------|
| `job_id` | string | 是 | — | 视频任务 ID |
| `output_dir` | string | 否 | `users/<user>/download/` | 输出目录 |
| `filename` | string | 否 | 自动生成 | 可选输出文件名 |

## 结果说明

### video_generate
- 成功：返回 JSON，含 `job_id` 和任务创建信息
- 失败：返回 `ERROR:` 前缀的错误信息

### video_status
- 成功：返回 JSON，含任务状态（pending/processing/completed/failed）和进度信息
- 失败：返回 `ERROR:` 前缀的错误信息

### video_download
- 成功：返回工具结果 JSON，含文件 artifact（下载路径）
- 失败：返回 `ERROR:` 前缀的错误信息

## 前置条件

- 需要 provider 支持 `video_generation` 能力
- 需配置 `video_generation_model`（config.json 专用配置）
- 视频生成是异步任务，需先 `generate` → 轮询 `status` → 完成后 `download`

## 典型流程

```text
1. video_generate(prompt=" cats playing in garden")  →  返回 job_id
2. video_status(job_id="xxx")                          →  等待 completed
3. video_download(job_id="xxx")                        →  保存到 download/
```

## 常见规范

- 生成模式由传入参数决定：只传 `prompt` = 文生视频，传 `image` = 图生视频，传 `video` = 视频生视频
- `image` 和 `video` 参数支持本地路径、HTTP URL 和 data URL
- 输出目录默认为 `users/<user>/download/`

## 常见处理办法

- **任务长时间 pending**：视频生成耗时较长（通常 30-180 秒），耐心轮询
- **任务失败**：检查 `prompt` 是否合规、模型是否支持当前参数组合
- **下载失败**：先用 `video_status` 确认任务状态为 `completed` 再下载

## 常见教训

- 视频生成是异步任务，不能一步到位，需走 generate → status → download 三步流程
- 下载前必须确认任务状态为 `completed`，否则会下载失败
- 部分 provider 对 `duration` 和 `size` 有严格限制，超范围参数可能被拒绝