用途:通过字节跳动官方 dreamina CLI 生成图片与视频,并查询任务历史、额度和登录状态。它只是指令层,不封装任何 SDK,每个动作都对应本机已安装的 dreamina 子命令。
使用前检查:先确认 dreamina 是否已安装(command -v dreamina),以及登录是否有效(dreamina user_credit,正常返回含额度信息的 JSON)。未安装时官方安装命令为 curl -fsSL https://jimeng.jianying.com/cli | bash,安装会写入本机,应先确认再执行;其他平台可参考 https://jimeng.jianying.com/ai-tool/install。登录失效时运行 dreamina login,凭证自动存入 ~/.dreamina_cli/credential.json。user_credit 成功前不要进入生成步骤。
主要子命令:文本生成图片用 dreamina text2image,图像转换或重绘用 dreamina image2image,文生视频用 dreamina text2video,图生视频用 dreamina image2video,获取异步结果用 dreamina query_result,浏览历史用 dreamina list_task。
关键参数:prompt 用双引号包裹;图片支持 --ratio 和 --resolution_type(1k/2k/4k),image2image 用复数 --images 传入参考图;视频支持 --duration、--ratio、--video_resolution(480P/720P/1080P),image2video 用单数 --image 传入单个关键帧。图片轮询 --poll=30,视频 --poll=60。注意 image2image 用 --images,image2video 用 --image,混用会报未知标志错误。成功时 CLI 输出 JSON,包含结果 URL 或本地路径;可用 --download_dir 下载到本地(需先创建目录)。轮询超时可用 dreamina query_result --submit_id=<id> --download_dir=./out 重试,失败信息应原样转达。v1.3.5+ 支持会话,仅在用户明确要求切换或列出时使用。详细参数见 references 下的 cli-commands.md、install-and-login.md、ratio-resolution-map.md 和 troubleshooting.md。
限制:仅适用于即梦/Dreamina 场景;用户未点名即梦时建议使用 happy-image-gen / happy-video-gen;平台与版本兼容性、收费与价格等未在资料中提供。