---
name: seedream
description: 使用火山引擎 Seedream/Seedance API 生成高质量图片和视频。适用于文生图、图生图、文生视频、图生视频以及生成关联组图的场景。
---

# Seedream

本 Skill 封装了火山引擎（Volcengine）的 Seedream-4.5 图片生成和 Seedance-1.5 视频生成能力，支持文生图、图生图、文生视频、图生视频。

## 使用方法

### 文生图
生成单张图片（默认分辨率）：
```bash
python {baseDir}/scripts/generate_image.py --prompt "一只赛博朋克风格的猫"
```

指定分辨率（如 2K, 4K 或具体像素）：
```bash
python {baseDir}/scripts/generate_image.py --prompt "壮丽的山川日出" --size "2K"
```

### 图生图
提供参考图片 URL：
```bash
python {baseDir}/scripts/generate_image.py --prompt "将其风格变为印象派" --image "https://example.com/input.jpg"
```

### 生成组图
生成一组内容关联的图片（最多 15 张）：
```bash
python {baseDir}/scripts/generate_image.py --prompt "一个宇航员在不同行星上的探险经历" --sequential --max-images 4
```

## 参数说明

- `--prompt`: (必选) 图像生成的文本描述。
- `--model`: (可选) 模型 ID，默认为 `doubao-seedream-4-5-251128`。
- `--size`: (可选) 图像尺寸。支持 `2K`, `4K` 或 `2048x2048` 等格式。
- `--image`: (可选) 参考图 URL 或 Base64 编码。
- `--sequential`: (可选) 开启组图生成功能。
- `--max-images`: (可选) 组图生成的最大图片数量（1-15）。

## 工作流

1. 调用 `generate_image.py` 脚本。
2. 脚本会输出以 `MEDIA_URL: ` 开头的图片链接。
3. 提取链接并使用 Markdown 语法展示：`![Generated Image](URL)`。
4. 除非用户要求，否则无需下载图片。

## 注意事项

- Seedream-4.5 支持中英文提示词。
- 组图功能仅在 Seedream-4.5/4.0 模型中有效。
- 确保提供的图片 URL 可公开访问。

---

## 视频生成

### 文生视频
```bash
python {baseDir}/scripts/generate_video.py --prompt "无人机以极快速度穿越复杂障碍或自然奇观，带来沉浸式飞行体验"
```

### 图生视频
提供参考图片 URL：
```bash
python {baseDir}/scripts/generate_video.py --prompt "让画面中的人物动起来" --image "https://example.com/input.jpg"
```

指定视频时长（5 或 10 秒）：
```bash
python {baseDir}/scripts/generate_video.py --prompt "日出延时摄影" --duration 10
```

固定摄像机位：
```bash
python {baseDir}/scripts/generate_video.py --prompt "一只猫在桌上跳跃" --camera-fixed
```

### 视频参数说明

- `--prompt`: (必选) 视频生成的文本描述。
- `--model`: (可选) 模型 ID，默认为 `doubao-seedance-1-5-pro-251215`。
- `--image`: (可选) 参考图 URL，用于图生视频。
- `--duration`: (可选) 视频时长，5 或 10 秒，默认 5。
- `--camera-fixed`: (可选) 固定摄像机位。
- `--no-watermark`: (可选) 去除水印。
- `--poll-interval`: (可选) 轮询间隔秒数，默认 5。
- `--max-wait`: (可选) 最大等待秒数，默认 600。

### 视频生成工作流

1. 调用 `generate_video.py` 脚本。
2. 脚本会自动创建异步任务并轮询结果。
3. 完成后输出以 `MEDIA_URL: ` 开头的视频链接。
4. 提取链接并展示给用户（视频链接可直接访问）。
5. 视频生成通常需要 1-3 分钟，请耐心等待。

### 视频注意事项

- Seedance 视频生成是异步任务，脚本会自动轮询等待结果。
- 支持中英文提示词。
- 图生视频时，确保图片 URL 可公开访问。
