jimeng-video
# jimeng-video Skill v2.0
即梦AI(Dreamina)视频生成工具 - **带声音版本**
## 🎉 v2.0 重大更新
**✅ 支持生成带声音的视频!**
默认使用 `doubao-seedance-1-5-pro-251215` 模型,生成的视频自带音频(环境音/背景音乐/音效),无需后期配音!
---
## 功能特性
- **🎵 文生音视频**:输入文字描述,自动生成带声音的视频
- **🎵 图生音视频**:上传图片,生成带声音的动态视频
- **🎨 多模型支持**:支持多个视频生成模型(带声音/纯视频)
- **⚡ 批量生成**:支持一次性生成多个视频
- **📊 任务管理**:创建任务、查询状态、获取结果
---
## 支持的模型
### 🌟 推荐模型(默认)
| 模型ID | 类型 | 特点 | 音频 |
|:---|:---|:---|:---:|
| **`doubao-seedance-1-5-pro-251215`** | **文生音视频** | **生成视频自带声音**,效果最好 | ✅ **带声音** |
### 其他可用模型
| 模型ID | 类型 | 特点 | 音频 |
|:---|:---|:---|:---:|
| `doubao-seedance-1-0-pro-250528` | 视频生成 | Pro版,质量高 | ❌ 无声 |
| `doubao-seedance-1-0-lite-t2v-250428` | 文生视频 | 轻量版,速度快 | ❌ 无声 |
| `doubao-seedance-2-0-260128` | 视频生成 | 最新版,功能强 | ❌ 无声 |
---
## 快速开始
### 1. 生成带声音的视频(默认)
```bash
# 使用默认模型(带声音)
jimeng-video generate \
-p "一匹马高高跃起,四个字从左到右书写,水墨风格,文字内容是马年大吉" \
-o output.mp4
# 生成的视频将包含:画面 + 自动生成的音效/音乐
```
### 2. 指定纯视频模型(无声)
```bash
# 使用旧版模型(无声,如需纯画面)
jimeng-video generate \
-m doubao-seedance-1-0-lite-t2v-250428 \
-p "夕阳下的海滩,金色的阳光洒在波浪上" \
-o beach.mp4
```
### 3. 批量生成
```bash
# 从文件批量生成
jimeng-video batch \
--file prompts.txt \
--output-dir ./videos/
```
### 4. 查询任务状态
```bash
# 查询指定任务
jimeng-video status --task-id cgt-20260228005550-95t42
```
---
## API 调用示例
### 生成带声音的视频
```bash
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${API_KEY}" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "你的提示词内容"
}
]
}'
```
### 查询结果
```bash
curl -X GET "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{task_id}" \
-H "Authorization: Bearer ${API_KEY}"
```
---
## 提示词技巧
### 带声音视频的有效提示词结构
```
[场景描述] + [动作/事件] + [氛围/情绪] + [声音提示]
```
**示例(带声音暗示):**
- ✅ "热闹的台球厅,球杆击球声,人群的欢呼,专业比赛氛围"
- ✅ "海浪拍打沙滩,海鸥叫声,轻松惬意的夏日午后"
- ✅ "繁忙的城市街道,车声喇叭声,霓虹灯闪烁的夜晚"
**声音相关关键词(帮助模型生成更好音效):**
- 环境音:"嘈杂的人群声"、"雨声"、"风声"
- 动作音:"击球声"、"键盘敲击声"、"脚步声"
- 情绪音:"欢快的音乐"、"紧张的氛围"、"舒缓的旋律"
---
## 配置说明
### 环境变量
在 `~/.openclaw/.credentials/volcengine-dreamina.env` 中配置:
```bash
VOLCENGINE_ACCESS_KEY_ID=your-access-key-id
VOLCENGINE_SECRET_ACCESS_KEY=your-secret-key
```
### 获取API Key
1. 登录火山引擎控制台:`console.volcengine.com`
2. 进入「访问控制」→「API Key管理」
3. 创建新的API Key
4. 开通即梦AI视频生成服务
---
## 模型对比
| 维度 | 1.5 Pro(带声音) | 1.0 Lite(无声) |
|:---|:---|:---|
| **音频** | ✅ 自动生成 | ❌ 需后期添加 |
| **画质** | 1080p | 720p/1080p |
| **生成速度** | 30-40秒 | 15-25秒 |
| **适用场景** | 短视频成品 | 素材/需后期配音 |
| **价格** | 较高 | 较低 |
**建议:**
- **成品视频** → 使用 1.5 Pro(带声音)
- **素材剪辑** → 使用 1.0 Lite(无声)
---
## 返回结果
### 成功响应(带声音模型)
```json
{
"id": "cgt-20260228140147-6t2sz",
"model": "doubao-seedance-1-5-pro-251215",
"status": "succeeded",
"content": {
"video_url": "https://..."
},
"generate_audio": true,
"resolution": "720p",
"duration": 5,
"framespersecond": 24
}
```
**关键字段:**
- `generate_audio: true` - 表示包含音频生成
- `video_url` - 视频下载链接(包含音视频)
- `duration` - 视频时长(秒)
---
## 使用场景
- **短视频创作**:直接生成带声音的成品视频
- **广告制作**:快速产出带音效的广告素材
- **内容运营**:自动生成带背景音的短视频
- **创意实验**:AI自动生成完整音视频内容
---
## 注意事项
1. **音频质量**:自动生成的音频是AI合成的环境音/音乐,不是真实录音
2. **生成时间**:带声音版本比无声版本慢约50%(30-40秒 vs 15-25秒)
3. **定制音频**:如需特定音乐,建议用无声版本+后期添加
4. **音量平衡**:自动音频音量适中,如需调整请后期处理
---
## 故障排查
### 模型未开通
**错误:** `ModelNotOpen`
**解决:** 在火山引擎控制台开通即梦AI 1.5 Pro服务
### 生成超时
**现象:** 任务长时间 running
**解决:** 带声音模型生成较慢,请耐心等待(最长2分钟)
### 音频不满意
**解决:**
- 调整提示词中的声音描述
- 或使用无声模型+后期添加自定义音乐
---
## 更新日志
### v2.0.0 (2026-02-28)
- ✅ 升级默认模型为 `doubao-seedance-1-5-pro-251215`
- ✅ 支持生成带声音的视频
- ✅ 优化提示词文档,增加声音相关技巧
- ✅ 添加模型对比说明
### v1.0.0 (2026-02-27)
- 初始版本
- 支持基础视频生成功能
---
**让视频创作更简单,一步到位生成带声音的成品!** 🎬🎵
标签
skill
ai