self-media-james/.claude/commands/generate-video.md
邓文兵 9408daeeff feat(jimeng): 添加即梦AI视频生成功能
- 新增 scripts/jimeng_video_gen.py 脚本支持文生视频和图生视频
- 实现 t2v 和 i2v 两种生成模式,支持多种分辨率和宽高比
- 添加轮询任务状态和视频下载功能
- 更新即梦AI文档,补充视频生成API接口说明
- 新增 .claude/commands/generate-video.md 命令使用指南
- 扩展即梦API文档,包含视频生成参数配置和调用示例
2026-03-12 19:52:07 +08:00

63 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 即梦 AI 视频生成
使用即梦 AI火山引擎生成视频。
## 使用方式
用户会提供:
1. **prompt**:视频描述(中文)
2. **output_path**:输出路径(可选,默认保存到当前工作目录)
3. **mode**:生成模式(可选,默认 t2v 文生视频)
## 执行步骤
1. 激活项目虚拟环境:`source .venv/bin/activate`
2. 调用 `scripts/jimeng_video_gen.py` 生成视频
3. 根据用户需求选择合适的参数:
- **文生视频**`--mode t2v`(默认)
- **图生视频-首帧**`--mode i2v --image <图片路径或URL>`
- **分辨率**`--resolution 720p`(默认)或 `--resolution 1080p`
- **宽高比**`--aspect-ratio 16:9`(默认),支持 `16:9, 4:3, 1:1, 3:4, 9:16, 21:9`
- **帧数**`--frames 121`默认约5秒
4. 展示生成结果给用户
## 调用示例
```bash
# 文生视频 (720P, 16:9)
source .venv/bin/activate && python scripts/jimeng_video_gen.py "视频描述prompt" "输出路径.mp4"
# 文生视频 (1080P)
source .venv/bin/activate && python scripts/jimeng_video_gen.py "视频描述prompt" "输出路径.mp4" --resolution 1080p
# 图生视频-首帧
source .venv/bin/activate && python scripts/jimeng_video_gen.py "视频描述prompt" "输出路径.mp4" --mode i2v --image "首帧图片.jpg"
# 竖屏视频
source .venv/bin/activate && python scripts/jimeng_video_gen.py "视频描述prompt" "输出路径.mp4" --aspect-ratio 9:16
```
## Prompt 技巧
- **基础结构**:主体 + 背景 + 镜头 + 动作
- **运镜词汇**:镜头切换、平移、推轨、环形跟踪、特写、俯拍、航拍
- **多镜头叙事**:支持描述连贯场景切换
## 注意事项
- 视频生成耗时较长,通常 20-30 秒完成,最长等待 3 分钟
- 支持分辨率720P默认和 1080P
- 支持宽高比16:9、4:3、1:1、3:4、9:16、21:9
- 脚本位于 `scripts/jimeng_video_gen.py`,依赖 `scripts/jimeng_gen.py` 的签名逻辑
- 虚拟环境位于 `.venv/`,已安装 `requests`
## 可用模型 (req_key)
| 功能 | req_key | 分辨率 |
|------|---------|--------|
| 文生视频 | `jimeng_t2v_v30` | 720P |
| 文生视频 | `jimeng_t2v_v30_1080p` | 1080P |
| 图生视频-首帧 | `jimeng_i2v_first_v30` | 720P |
$ARGUMENTS