---
name: 即梦AI生成
description: 使用即梦（Dreamina）CLI 生成图片或视频，支持文生图、图生图、文生视频、图生视频、多图生视频、多模态生视频
argument-hint: <生成需求描述>
---

## 用户输入

```text
$ARGUMENTS
```

## 概述

即梦（Dreamina）是字节跳动旗下的 AI 创作平台。`dreamina` CLI 是其命令行入口，允许在任意环境中使用即梦的生成能力。

详细文档：https://bytedance.larkoffice.com/wiki/FWTwwm0bGiishxkKOoScdHR2nsg

## 前置条件

### 安装 CLI

```bash
curl -fsSL https://jimeng.jianying.com/cli | bash
```

### 登录

```bash
dreamina login
```

若登录出错，可用 `--debug` 重试：

```bash
dreamina login --debug
```

登录状态存储于 `~/.dreamina_cli/`，优先复用已有登录状态。

## 核心命令

**关键原则：实际执行前必须先用 `-h` 查看子命令的具体参数**，不同命令支持的模型、比例、时长、分辨率可能不同。

### 1. 查询额度

```bash
dreamina user_credit
```

### 2. 文生图（text2image）

```bash
dreamina text2image -h
dreamina text2image --prompt "<描述词>" [其他参数]
```

### 3. 图生图（image2image）

```bash
dreamina image2image -h
dreamina image2image --image "<图片路径>" --prompt "<描述词>" [其他参数]
```

### 4. 文生视频（text2video）

```bash
dreamina text2video -h
dreamina text2video --prompt "<描述词>" [其他参数]
```

### 5. 图生视频（image2video）

```bash
dreamina image2video -h
dreamina image2video --image "<图片路径>" [其他参数]
```

适用场景：基于单张图片生成动态视频（如让静态图动起来）。注意：分辨率继承输入图片比例，不支持 `--ratio` 参数。

### 6. 多图生视频（multiframe2video）

```bash
dreamina multiframe2video -h
dreamina multiframe2video --images "<图1>" "<图2>" ... [其他参数]
```

适用场景：多张图片串联成连贯故事视频（智能多帧流）。不支持模型选择。

### 7. 多模态生视频（multimodal2video）

```bash
dreamina multimodal2video -h
dreamina multimodal2video --prompt "<描述词>" [--image "<图>"] [--video "<视频>"] [--audio "<音频>"] [其他参数]
```

适用场景：旗舰视频模式，支持图片、视频、音频等多模态参考输入。支持 `--ratio` 参数控制输出比例，Pro 版额外支持 1080p。

### 8. 查询异步任务结果（query_result）

```bash
dreamina query_result --submit_id <任务ID>
```

### 9. 查看历史任务（list_task）

```bash
dreamina list_task -h
dreamina list_task [过滤参数]
```

## 工作会话（Session）

```bash
dreamina session -h
dreamina session list
dreamina session create "<名称>"
dreamina session use <ID>
```

## 标准工作流程

### 步骤 1：确认需求

根据 `$ARGUMENTS` 判断生成类型：

| 用户说 | 对应命令 |
|--------|---------|
| "生成一张...图片"、"画一个..." | `text2image` |
| "把这张图变成...风格"、"基于这张图生成..." | `image2image` |
| "生成一段...视频"、"做一个...动画" | `text2video` |
| "让这张图动起来"、"这张图生成视频" | `image2video` |
| "用这几张图做一个故事视频" | `multiframe2video` |
| 同时提供图片+视频+音频参考 | `multimodal2video` |

### 步骤 2：查看命令帮助

```bash
dreamina <子命令> -h
```

### 步骤 3：检查额度

```bash
dreamina user_credit
```

### 步骤 4：提交生成任务

- **明确告知用户**即将消耗额度
- **小批量**执行，每次提交少量任务便于审查
- **记录**每次测试的命令、参数、`submit_id`、最终状态

### 步骤 5：轮询结果

```bash
dreamina query_result --submit_id <ID>
```

- `gen_status` 为 `querying` → 保存 `submit_id`，稍后查询
- `gen_status` 为 `success` → 获取结果
- `gen_status` 为 `fail` → 查看 `fail_reason`，告知用户具体原因

### 步骤 6：下载结果到本地

下载到 `知识/金鹏/20260605/`。

**命名格式**：`yyyyMMdd_00n.<扩展名>`

- `yyyyMMdd`：当前日期
- `00n`：图片序号，001, 002, ...
- `<扩展名>`：图片 `.png`，视频 `.mp4`

示例：
- `20260605_001.png`
- `20260605_002.png`
- `20260605_003.mp4`

```bash
mkdir -p 知识/金鹏/20260605
curl -o "知识/金鹏/20260605/20260605-001.png" "<image_url>"
```

### 步骤 7：输出结果

向用户展示：
- 生成的图片/视频本地路径
- 使用的命令和参数
- `submit_id`（便于后续追溯）

## 账户与模型

### 账户信息

- **VIP 等级**：maestro（大师级，最高等级）
- 大部分图片模型（3.0/3.1/4.0/4.6/5.0）免费，仅 4.1（2 积分）和 4.5（4 积分）消耗积分
- 生成前用 `dreamina user_credit` 确认余额

### 模型选择规则

本账号为 VIP maestro，**所有生成始终使用最高质量模型**：

| 命令 | 默认模型 | 备选 |
|------|---------|------|
| **text2image** / **image2image** | `5.0`（最新 4K，免费） | `4.6` |
| **text2video** | `seedance2.0_vip`（70 积分） | `seedance2.0fast_vip` |
| **image2video** / **multimodal2video** | `seedance2.0fast_vip`（55 积分） | `seedance2.0_vip`（追求极致或需 1080p 时） |

关键约束：
- **非 VIP 模型不可用**：`seedance2.0` 排队 33 万+，`seedance2.0fast` 频繁触发并发限制
- 所有模型生成文字时均可能出现拼写错误，海报类需求需后期修图
- 首次使用前通过 `-h` 确认模型列表是否有更新

> 详细模型对比测试数据与场景推荐矩阵见 `.claude/memory/dreamina.md`

## 常见问题

### AIGC 合规确认

返回 `AigcComplianceConfirmationRequired` 时，需先在即梦 Web 端完成合规确认后重试。

### 排队 / 并发限制

通过 `query_result` 持续轮询，或更新 CLI：

```bash
curl -fsSL https://jimeng.jianying.com/cli | bash
```

### 日志排查

日志位于 `~/.dreamina_cli/logs/`。

## 注意事项

1. **区分只读和付费操作**：`user_credit`、`query_result`、`list_task`、`-h` 只读；生成命令消耗额度
2. **异步等待**：图片和视频生成是异步的，提交和查询分开执行
3. **不同命令参数不通用**：不要假设某命令的模型、比例、时长、分辨率适用于其他命令
4. **帮助优先**：不确定参数时，始终先用 `-h` 查看

## 执行后复盘

每次执行本命令后，必须完成以下步骤：

### 1. 分析执行过程

分析本次执行过程的优点和缺点：

- **优点**：哪些步骤/设计执行顺畅、达到预期效果？
- **缺点**：哪些步骤/设计存在问题或可改进之处？

### 2. 评估是否需要更新命令

基于上述分析，判断当前命令是否需要更新。如果执行顺利无问题，注明"当前命令无需更新"。

### 3. 如需更新，提出建议并由人类确认

如果发现需要改进的地方，给出具体的更新方案（修改内容、位置、原因），由人类用户确认后再执行对命令文件的修改。

> **原则**：可改可不改的不改；只提出对执行质量有实质影响的更新建议。
