openclaw-ai-opc Seedance Video - AI视频生成
概述
本技能封装了 DZWL AI 的 Seedance 2.0 视频生成 API，支持通过自然语言描述生成高质量视频。
核心能力：
- 文本生成视频（Text-to-Video）
- 支持多种分辨率（480p、720p等）
- 支持多种宽高比（16:9、9:16、1:1等）
- 可选音频生成
- 自动轮询任务状态直到完成
使用流程
1. 发起视频生成任务
调用 API 提交生成任务，获取任务 ID：
curl --request POST \
--url https://dzwlai.com/apiuser/_open/ai/task/api/seedance/gene2video \
--header 'Content-Type: application/json' \
--header 'x-token: <YOUR_TOKEN>' \
--data '{
"modelName": "seedance-2-0-fast",
"prompt": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true,
"watermark": false,
"web_search": false,
"return_last_frame": true,
"callbackUrl": ""
}'
响应示例：
{
"code": 200,
"msg": "您已成功提交创作任务，目前剩余并发任务数为3",
"data": {
"id": "1909553892857782274",
"status": "create"
}
}
2. 查询任务状态
使用任务 ID 轮询获取生成结果：
curl --request GET \
--url 'https://dzwlai.com/apiuser/_open/ai/task/api/getState?ids=<TASK_ID>' \
--header 'x-token: <YOUR_TOKEN>'
任务状态：
create- 任务已创建processing- 正在生成success- 生成成功（返回视频URL）failed- 生成失败
3. 获取视频结果
当状态为 success 时，响应中会包含视频下载 URL。
参数说明
必填参数
| 参数 | 类型 | 说明 |
|---|---|---|
| modelName | string | 模型名称，固定为 seedance-2-0-fast |
| prompt | string | 视频描述提示词，支持中英文 |
可选参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| duration | number | 5 | 视频时长（秒） |
| resolution | string | "480p" | 分辨率：480p、720p等 |
| aspect_ratio | string | "16:9" | 宽高比：16:9、9:16、1:1等 |
| generate_audio | boolean | false | 是否生成音频 |
| watermark | boolean | true | 是否添加水印 |
| web_search | boolean | false | 是否启用网络搜索增强 |
| return_last_frame | boolean | false | 是否返回最后一帧 |
| callbackUrl | string | "" | 回调URL（可选） |
最佳实践
提示词编写建议
- 明确风格：开头说明风格（写实、动漫、电影感等）
- 场景描述：清晰描述场景、主体、动作
- 镜头运动：描述镜头变化（拉近、推远、平移等）
- 细节补充：添加光影、氛围等细节
示例提示词：
写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，
镜头逐渐拉近，最终定格在一朵雏菊花的特写上，
花瓣上有几颗晶莹的露珠
分辨率选择建议
- 480p：快速预览，生成速度快
- 720p：平衡质量与速度
- 1080p：高质量输出（如支持）
宽高比选择
- 16:9：横屏视频，适合风景、电影
- 9:16：竖屏视频，适合短视频平台
- 1:1：方形视频，适合社交媒体
脚本工具
本技能提供了 Python 脚本简化 API 调用：
scripts/generate_video.py
自动化视频生成脚本，封装了任务提交和状态轮询。
python scripts/generate_video.py \
--token <YOUR_TOKEN> \
--prompt "你的视频描述" \
--duration 5 \
--resolution 480p \
--aspect-ratio 16:9 \
--generate-audio
参数：
--token：API令牌（必填）--prompt：视频描述（必填）--duration：时长（秒）--resolution：分辨率--aspect-ratio：宽高比--generate-audio：生成音频标志--no-watermark：去除水印--output：输出文件路径
错误处理
常见错误
- 令牌无效：检查 x-token 是否正确
- 并发限制：等待其他任务完成
- 参数错误：检查请求参数格式
重试策略
- 网络错误：指数退避重试
- 并发限制：等待后重试
- 生成失败：检查提示词是否合规
API 参考
详细 API 文档见：references/api_reference.md