SD1.5pro 视频生成

技能文档

---
name: sd15pro-video-gen
title: SD1.5pro 视频生成
category: 内容创作
description: 调用 SD1.5pro 视频生成模型，支持文本生视频与图生视频，异步任务自动轮询并下载成片到本地。当用户需要生成 AI 短视频、文生视频、图生视频或为内容创作产出视频素材时触发。触发词：视频生成、文生视频、图生视频、AI短视频。
---

# SD1.5pro 视频生成

调用 SD1.5pro 视频生成 API，支持纯文本生成视频和参考图生成视频，任务异步处理，自动轮询状态并下载成片。

## 首次使用配置

在技能目录中创建 `config.json` 文件（可复制 `config.example.json` 修改）：

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

- **api_key**：API Key（必需），在云服务商控制台的 API Key 管理中创建
- **model**：模型 ID（必需），在模型服务中查找 SD1.5pro 模型的接入点 ID

## 技能工作流

### 步骤1：确认配置

确认技能目录下存在 `config.json` 且包含 `api_key` 与 `model`；缺失时按「首次使用配置」引导用户创建，不得猜测或编造密钥。

### 步骤2：创建生成任务

根据用户需求构造提示词，调用 API 创建视频生成任务；提供参考图时附带图片 URL 走图生视频。

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

视频生成为异步过程，轮询任务状态直至完成，通常需要几分钟。

### 步骤4：下载成片

任务完成后自动下载视频到指定输出路径（默认桌面），输出 MP4 格式。

## 使用方法

```bash
# 仅文本生成
python scripts/generate_video.py "提示词"

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

# 指定输出路径
python scripts/generate_video.py "提示词" --output "./视频.mp4"
```

## 参数说明

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

## 示例

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

python scripts/generate_video.py "无人机穿越障碍" \
  --image "https://example.com/reference.jpg" --duration 10 --watermark False
```

## 错误处理

| 场景 | 处理方式 |
|------|----------|
| 配置文件不存在 | 按「首次使用配置」创建 `config.json` |
| API Key 无效 | 检查 Key 是否正确、是否过期、是否有该模型权限 |
| 模型 ID 错误 | 确认接入点 ID 是否有效 |
| 网络错误 | 检查网络连接和防火墙设置 |

## 注意事项

- 视频生成为异步任务，可能需要几分钟，请耐心等待轮询结果
- 默认时长 5 秒，最大时长取决于模型限制
- 支持 MP4 格式输出

使用说明

# SD1.5pro 视频生成

一句话描述：调用 SD1.5pro 模型，从文本或参考图生成 AI 短视频，自动轮询任务并下载成片。

## 使用

首次使用前在技能目录创建 `config.json`（模板见 `config.example.json`）：

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

生成视频：

```bash
python scripts/generate_video.py "冬日的杭州西湖，雪花纷纷扬扬飘落" --duration 5 --output ./demo.mp4
```

## 工作原理

脚本向视频生成 API 提交异步任务，轮询任务状态直至完成，再把成片下载到指定路径；支持 `--image` 参考图走图生视频，`--watermark`、`--camera-fixed` 等参数控制输出效果。

如何安装此技能？

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