用途:moda-image 用于把图片本身作为交付物(用户要的成品文件),而非设计稿中的图层。设计过程中的配图(封面、社交主图、网站背景)归属对应格式技能处理;视频放大或重构图属于 moda-video-clip,Logo/标志设计属于 moda-social。
前置:每会话需加载一次 moda-core(step-0、write contract、free/metered map)。无法加载时:先运行 moda doctor --json;创建前运行 moda brand list;写操作固定 revision 需用上次读取的版本,遇到 stale_revision 时重读并重试一次;画布链接一出现就发送;卡住或失败可用 moda ask "<问题>"(免费、快速,勿猜测)。
主要操作:生成 moda media generate-image --prompt "[完整指令]" --model [M] --aspect-ratio [R] -o [out.png];生成式编辑 moda media edit-image --prompt "[完整编辑与需保留内容]" --model [M] --source [file_…];去背景 moda media remove-background [file_…];放大 moda media upscale [file_…] --scale 2(或 4);扩图 moda media outpaint [file_…] --aspect-ratio 16:9 或按边 --expand-top/-bottom/-left/-right PX。输入可为本地路径或 file_ 引用,moda file upload 可把文件放入团队盘。
规则:先用 moda media models 查看能力,--model 必需且无 auto,宽高比/分辨率/--model-params 为按模型的枚举,需原样复制。prompt 原样传给模型,需写全主题、风格、构图及编辑需保留项。--source 是待修改内容,--reference 控制风格、配色或构图。outpaint 不接受 prompt,--aspect-ratio 与按边像素二选一,单边上限 2048px、扩展画布上限 4MP,计费按源图加结果。结果需亲自查看。品牌相关用 moda brand show [KIT] --json,配色取自 kit 而非记忆。
交付:通过 -o 落盘或 moda file download [file_…] -o [PATH] 获取 file_ 引用,可复用于后续媒体调用与标记填充。计费失败(如 insufficient_credits)表示团队额度不足,如实说明且不重试。其余细节暂未提供。