# Seedance Video

> 基于字节 Seedance 模型的视频生成技能，支持文生视频（Text-to-Video）和图生视频（Image-to-Video），可生成高质量短视频。

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

---


# Seedance Video - 视频生成技能

基于字节跳动 Seedance 模型，支持文生视频和图生视频。

## 前置条件

1. 需要火山引擎 API Key，设置环境变量 `ARK_API_KEY`
2. 安装 SDK：`pip install 'volcengine-python-sdk[ark]'`

## 使用方法

### 文生视频（Text-to-Video）

当用户提供文字描述要求生成视频时，执行 `{baseDir}/scripts/text_to_video.py`：

```bash
python3 {baseDir}/scripts/text_to_video.py \
  --prompt "用户的视频描述" \
  --ratio "16:9" \
  --duration 5 \
  --output "{workDir}/output_video.mp4"
```

参数说明：
- `--prompt`：视频描述文本（必填）
- `--ratio`：视频比例，可选 `16:9`、`9:16`、`1:1`（默认 `16:9`）
- `--duration`：视频时长秒数，可选 5 或 10（默认 5）
- `--output`：输出文件路径（必填）
- `--model`：模型 ID（默认 `doubao-seedance-1-5-pro-251215`）
- `--seed`：随机种子（可选，用于复现）

### 图生视频（Image-to-Video）

当用户提供图片要求生成视频时，执行 `{baseDir}/scripts/image_to_video.py`：

```bash
python3 {baseDir}/scripts/image_to_video.py \
  --image "/path/to/image.jpg" \
  --prompt "视频动作描述" \
  --ratio "16:9" \
  --duration 5 \
  --output "{workDir}/output_video.mp4"
```

参数说明：
- `--image`：输入图片路径（必填）
- `--prompt`：动作/运镜描述（可选，增强效果）
- 其余参数同文生视频

## 输出规范

1. 视频生成是异步任务，脚本会自动轮询直到完成
2. 成功后将视频下载到指定 `--output` 路径
3. 向用户展示生成的视频文件路径，并提供预览
4. 如果生成失败，显示错误信息并建议用户调整提示词

## 提示词优化建议

生成高质量视频的提示词模板：`主体 + 场景 + 动作 + 运镜 + 风格 + 画质`

示例：「写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠」

## 进阶资料

当需要更细的广告/叙事提示词范式时，读取 `references/prompt-recipes.md`。