seedance-video

SKILL.md

Seedance 视频生成

使用字节跳动 Seedance-1.5-pro 模型 (doubao-seedance-1-5-pro-251215) 根据文本或图片生成视频。

前置要求

安装 SDK:

pip install 'volcengine-python-sdk[ark]'

功能

文生视频: 根据文本提示词生成视频

图生视频: 根据首帧图片生成视频

自定义参数: 支持设置时长、宽高比、水印等

任务管理: 创建任务、查询状态、自动下载

使用方法
1. 快速生成视频 (文生视频)

cd ~/.openclaw/workspace/skills/seedance-video
python3 scripts/generate_video.py "一只可爱的猫咪在草地上玩耍" --wait -o cat.mp4

2. 自定义参数

python3 scripts/generate_video.py "日落时分的海边" \
  --duration 10 \
  --ratio 16:9 \
  --wait \
  -o sunset.mp4

3. 图生视频

python3 scripts/generate_video.py "猫咪动起来" \
  --image-url https://example.com/cat.jpg \
  --duration 5 \
  --wait

4. 仅创建任务（不等待）

python3 scripts/generate_video.py "星空下的城市" -o starry.mp4
# 返回任务ID

然后稍后查询状态并下载：

python3 scripts/generate_video.py --status <task_id> --wait -o starry.mp4

参数说明

参数
默认值
说明

prompt
必填
视频描述提示词

-o, --output
output.mp4
输出文件路径

-m, --model
doubao-seedance-1-5-pro-251215
模型 ID

-d, --duration
5
视频时长(秒)

-r, --ratio
16:9
宽高比 (16:9, 9:16, 1:1, 4:3 等)

--watermark
false
添加水印

--return-last-frame
false
返回最后一帧图片

--image-url
无
首帧图片 URL (图生视频)

--wait
false
等待视频生成完成并下载

--status
无
查询指定任务ID的状态

API 密钥配置

需要设置 ARK_API_KEY 或 SEEDANCE_API_KEY 环境变量。

配置方式（推荐）

复制配置模板：

cp .canghe-skills/.env.example .canghe-skills/.env

编辑 .canghe-skills/.env 文件，填写你的 API Key：

ARK_API_KEY=your-actual-api-key-here

或使用环境变量

export ARK_API_KEY="your-api-key"
# 或
export SEEDANCE_API_KEY="your-api-key"

加载优先级

系统环境变量 (process.env)

当前目录 .canghe-skills/.env

用户主目录 ~/.canghe-skills/.env

提示词优化建议

根据 Seedance-1.5-pro 提示词指南：

具体描述: 描述场景、主体、动作、环境等细节

风格明确: 指定摄影风格（如"电影感"、"纪录片风格"）

光线描述: 说明光线条件（如"黄金时刻"、"柔和自然光"）

镜头语言: 描述镜头运动（如"缓慢推进"、"稳定器拍摄"）

示例提示词

一只金毛犬在秋天的公园里奔跑，金色落叶飘落，下午的阳光透过树叶，电影感镜头，稳定器拍摄，4K画质

一个机器人在未来城市的霓虹灯街道上行走，赛博朋克风格，雨夜，倒影，广角镜头，电影色调

Python API 使用

from volcenginesdkarkruntime import Ark
from scripts.generate_video import create_video_task, wait_for_video

# 初始化客户端
client = Ark(
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    api_key="your-api-key"
)

# 创建视频任务
result = create_video_task(
    client=client,
    model="doubao-seedance-1-5-pro-251215",
    prompt="一只鸟在天空中飞翔",
    duration=5
)

task_id = result["task_id"]

# 等待并获取结果
final_status = wait_for_video(client, task_id)
video_url = final_status["video_url"]

注意事项

异步生成: 视频生成是异步过程，通常需要 30-60 秒

任务保存时间: 任务数据仅保留 24 小时

限流: 注意账号的 RPM 和并发数限制

视频比例: 建议视频宽高比与首帧图片比例接近

任务状态

queued: 排队中

running: 生成中

succeeded: 成功

failed: 失败