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
parent b4a6f9b79c
commit 9408daeeff
4 changed files with 338 additions and 1 deletions
@@ -1,4 +1,4 @@
-# 即梦 AI 图片生成 API
+# 即梦 AI API（图片生成 & 视频生成）

 ## 密钥

@@ -216,10 +216,139 @@ if __name__ == '__main__':
    print(json.dumps(result, indent=2, ensure_ascii=False))
 ```

+---
+
+## 视频生成接口
+
+### 模型与 req_key 对照表
+
+| 功能 | req_key | 分辨率 | 说明 |
+|------|---------|--------|------|
+| 文生视频 | `jimeng_t2v_v30` | 720P | 文本提示词生成视频 |
+| 文生视频 | `jimeng_t2v_v30_1080p` | 1080P | 文本提示词生成高清视频 |
+| 图生视频-首帧 | `jimeng_i2v_first_v30` | 720P | 首帧图片+提示词生成视频 |
+
+### 通用参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `req_key` | string | 是 | 模型标识，见上表 |
+| `prompt` | string | 是 | 视频描述提示词 |
+| `frames` | int | 否 | 视频帧数，默认 121（约5秒） |
+| `aspect_ratio` | string | 否 | 宽高比：`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` |
+| `seed` | int | 否 | 随机种子，-1 为随机 |
+
+### 图生视频额外参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `image_urls` | string[] | 首帧图片 URL 列表 |
+| `binary_data_base64` | string[] | 首帧图片 Base64 编码（与 image_urls 二选一） |
+
+### 文生视频 - 提交任务
+
+```
+POST https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
+```
+
+请求体：
+```json
+{
+  "req_key": "jimeng_t2v_v30",
+  "prompt": "一只橘猫趴在键盘上打字，桌面上有一杯咖啡，温暖的灯光",
+  "frames": 121,
+  "aspect_ratio": "16:9",
+  "seed": -1
+}
+```
+
+返回：
+```json
+{
+  "code": 10000,
+  "data": {
+    "task_id": "9675314167630911764"
+  },
+  "message": "Success"
+}
+```
+
+### 查询视频结果
+
+```
+POST https://visual.volcengineapi.com?Action=CVSync2AsyncGetResult&Version=2022-08-31
+```
+
+请求体：
+```json
+{
+  "req_key": "jimeng_t2v_v30",
+  "task_id": "9675314167630911764"
+}
+```
+
+返回（完成时）：
+```json
+{
+  "code": 10000,
+  "data": {
+    "status": "done",
+    "video_url": "https://v11-aiop.aigc-cloud.com/...",
+    "aigc_meta_tagged": false
+  },
+  "message": "Success"
+}
+```
+
+### 图生视频-首帧 - 提交任务
+
+```json
+{
+  "req_key": "jimeng_i2v_first_v30",
+  "prompt": "猫咪缓缓转头看向镜头",
+  "image_urls": ["https://example.com/cat.jpg"],
+  "frames": 121,
+  "seed": -1
+}
+```
+
+### Prompt 技巧
+
+- **基础结构**：主体 + 背景 + 镜头 + 动作
+- **运镜词汇**：镜头切换、平移、推轨、环形跟踪、特写、俯拍、航拍
+- **多镜头叙事**：支持描述连贯场景切换（3.0 Pro 特性）
+
+### Python 调用
+
+```bash
+source .venv/bin/activate
+
+# 文生视频 (720P)
+python scripts/jimeng_video_gen.py "一只橘猫趴在键盘上打字" output.mp4
+
+# 文生视频 (1080P)
+python scripts/jimeng_video_gen.py "一只橘猫趴在键盘上打字" output.mp4 --resolution 1080p
+
+# 图生视频-首帧
+python scripts/jimeng_video_gen.py "猫咪转头看镜头" output.mp4 --mode i2v --image first_frame.jpg
+
+# 指定宽高比和帧数
+python scripts/jimeng_video_gen.py "描述" output.mp4 --aspect-ratio 9:16 --frames 121
+```
+
 ## 参考文档

+### 图片生成
 - [即梦AI图片生成4.0 产品介绍](https://www.volcengine.com/docs/85621/1820192)
 - [即梦AI图片生成4.0 接口文档](https://www.volcengine.com/docs/85621/1817045)
+
+### 视频生成
+- [即梦AI视频生成3.0 Pro 产品介绍](https://www.volcengine.com/docs/85621/1783678)
+- [即梦AI视频生成3.0 Pro 接口文档](https://www.volcengine.com/docs/85621/1777001)
+- [即梦AI视频生成3.0 720P 接口文档](https://www.volcengine.com/docs/85621/1792710)
+- [即梦AI视频生成3.0 1080P 接口文档](https://www.volcengine.com/docs/85621/1792711)
+
+### 通用
 - [Python SDK (GitHub)](https://github.com/volcengine/volc-sdk-python)
 - [SDK 使用说明](https://www.volcengine.com/docs/6444/1340578)
 - [HTTP 请求示例](https://www.volcengine.com/docs/6444/1390583)