# 即梦 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