name

jimeng-cli

description

Use when the user needs AI image or video generation via the Dreamina (即梦) CLI tool `dreamina`. This includes text-to-image, text-to-video, image-to-image, image-to-video, multi-frame video, and multimodal video generation. Trigger this skill whenever the user mentions 即梦, jimeng, Dreamina, 文生图, 文生视频, 图生图, 图生视频, AI生图, AI生视频, wants to generate images or videos with AI, asks about dreamina commands, or references the dreamina CLI in any way — even if they just say something like "help me make a picture of a cat" or "generate a short video clip" without naming the tool explicitly, as long as the dreamina CLI is installed or relevant.

Dreamina (即梦) CLI

dreamina 是即梦 AI 图片/视频生成的本地命令行工具。「即梦」和「Dreamina」可互换使用。

前提条件：用户必须是即梦高级会员才能使用 dreamina CLI。 如果用户尚未订阅，提示其在即梦 Web 端完成会员升级后再使用。

每个子命令的完整参数说明见 references/ 目录下的对应文件。运行 dreamina <subcommand> -h 可获取最新的参数列表。

工作流程

1. 检查安装    →  which dreamina（未安装则参考下方说明安装）
2. 检查登录    →  dreamina user_credit（失败则 dreamina login）
3. 查看帮助    →  dreamina <subcommand> -h
4. 提交任务    →  dreamina <subcommand> ... --poll=30
5. 跟踪结果    →  dreamina query_result --submit_id=<id>

复用已有的登录会话——仅在用户明确要求时才执行 login、relogin 或 logout。生成命令会消耗积分，提交前先与用户确认。

安装

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

安装目录为 ~/.local/bin。若 shell 找不到 dreamina，执行 export PATH="$HOME/.local/bin:$PATH" 或重启终端。

命令选择

目标	命令	参考文件
查询积分余额	`user_credit`	user_credit.md
文本 → 图片	`text2image`	text2image.md
文本 → 视频	`text2video`	text2video.md
图片风格转换	`image2image`	image2image.md
单图 → 视频	`image2video`	image2video.md
多图 → 连贯故事视频	`multiframe2video`	multiframe2video.md
首尾帧 → 视频	`frames2video`	frames2video.md
旗舰多模态视频（Seedance 2.0）	`multimodal2video`	multimodal2video.md
图片超分放大	`image_upscale`	image_upscale.md
查询异步任务结果	`query_result`	query_result.md
浏览任务历史	`list_task`	list_task.md

使用具体命令前，先阅读对应的参考文件了解参数和模型/分辨率组合。

--poll 参数

生成命令默认异步执行。添加 --poll=<秒数> 可让 CLI 每秒轮询直到任务完成或超时。

按时完成 → 直接返回最终结果
超时 → 返回 querying 状态和 submit_id，用 dreamina query_result --submit_id=<id> 跟踪

默认使用 --poll=30。

判断任务是否成功

不要仅依赖退出码。提交成功的标志是 JSON 输出中包含：

submit_id — 存在
gen_status — querying（进行中）或 success（完成）

如果 gen_status 为 fail，读取 fail_reason 并向用户报告具体错误。

模型选择

不同子命令支持的模型、比例、时长和分辨率各不相同——不要假设它们通用。使用前先查看对应的参考文件或运行 dreamina <subcommand> -h。

seedance2.0 系列质量最高，但可能较慢且容量受限。除非用户明确要求高质量或指定 seedance2.0，否则默认选择更快的模型。

常见错误处理

现象	解决方法
`AigcComplianceConfirmationRequired`	部分模型首次使用需在即梦 Web 端完成授权确认，完成后重试
登录后权限不足	检查 `~/.dreamina_cli/config.toml` 是否存在；运行 `dreamina user_credit` 验证
登录挂起/浏览器无法打开	用 `dreamina login --debug` 重试
异步任务无结果	用 `--poll=30` 重新提交；超时后用 `query_result` 跟踪
切换账号	`dreamina relogin`

本地文件

路径	用途
`~/.dreamina_cli/config.toml`	环境配置
`~/.dreamina_cli/credential.json`	登录凭据
`~/.dreamina_cli/tasks.db`	任务提交历史
`~/.dreamina_cli/logs/`	运行日志