快速上手

  1. 新建项目:手机画面选竖屏,也可以选横屏或方形,都是 1080 画幅。
  2. 导入素材:先用几张不重要的图片、一小段视频或音乐。支持 PNG / JPEG / WebP、MP4 / WebM、WAV / MP3 / M4A,单个文件不超过 30 MiB。
  3. 加入剪辑:排好顺序,调整片段长短和音量。
  4. 更新预览:查看真正合成的画面和声音。
  5. 导出 MP4:核对设置并检查,确认导出后保存到你选择的位置,打开播放一遍。

导入只是把文件复制到本地工作区,不会上传。关闭导出窗口不会取消已开始的导出,可以在顶栏的任务里继续查看。

安装与视频工具

桌面试用版支持 macOS(Apple Silicon 与 Intel)。在下载页按芯片选择安装包,打开 DMG 并将 Mioon 拖到「应用程序」。

安装包不包含 FFmpeg 和 ffprobe。首次打开时可以点「下载并安装」,应用会校验下载的 7.1.5 版本。也可选择自己安装的工具,建议使用 7.1.5 或更新的完整功能构建,FFmpeg 4.4 不适用。

使用场景FFmpeg 需要提供
导出常见 MP4libx264、aac
字幕与本地模拟画面subtitles、drawtext 滤镜和字体支持
颜色、响度分析与匹配zscale、loudnorm、ebur128
图片与缩略图PNG、WebP 编解码

已使用 Homebrew 的 Mac 可以安装完整版本,并显示工具位置:

brew install ffmpeg-full
echo "$(brew --prefix ffmpeg-full)/bin/ffmpeg"
echo "$(brew --prefix ffmpeg-full)/bin/ffprobe"

使用自己的工具时,点「选择已安装的工具」,先选 ffmpeg 文件本身,再选 ffprobe。文件选择框里可以按 ⌘⇧G 粘贴上面得到的路径。之后可以在「设置 › 视频工具」查看状态。

系统阻止打开时,先确认文件来自官方发布页、架构选择正确。不要用删除隔离属性或关闭 Gatekeeper 的方式绕过。

画板、分镜与镜头

  • 画板:摆放素材、文字和镜头,连接参考图,比较生成的版本。节点位置只是布局,不决定成片顺序。
  • 分镜:按镜头顺序组织故事,「导出分镜」使用各镜头选中的版本。
  • 版本:每次生成都是新版本,旧版本和当时的提示词都保留。「选用」决定镜头当前用哪个版本。

把图片连接为镜头的「首帧参考」后,生成会用到它;灰色的视觉连线只用于整理思路,不参与生成。

参考片可以在素材库右键「拆解镜头」,在本机检测切点,不产生费用。支持 MP4 和 WebM,最长 10 分钟。

剪辑与导出

  • 剪辑界面:左侧素材库、中间大预览、右侧片段属性、下方多轨时间线。时间线按 30 帧 = 1 秒计算。
  • 加入时间线的是固定版本。镜头之后改选新版本,时间线顶部会提示,点「全部更新」才会替换,并可一次撤销。
  • 「时间线合成」预览由 FFmpeg 实际渲染,能听到片段音量、淡入淡出和混音;「源素材快速查看」只播放原文件。

导出设置

项目可选
尺寸原始(1080)、短边 720、短边 360
画质小文件、标准、高画质,或固定码率 2000 / 4000 / 8000 kb/s
固定参数MP4 · H.264 · AAC 128 kb/s · 30 fps

打开导出窗口不会立即导出。先检查,检查通过后再确认;改了设置或时间线需要重新检查。导出记录保留每次的名称和规格,之后编辑时间线不会覆盖旧成片。

连接 Mio

  1. 打开右上角的设置,选择「Mio」。
  2. 选择服务商预设,确认接口地址、协议和模型,填入密钥后点「保存」。密钥可以选「系统加密保存」或「仅本次运行」。
  3. 点「测试连接」。测试只发送一条固定消息,不发送项目内容。
  4. 第一次发送时确认授权,弹窗会列出目标地址、模型、发送范围和费用提示。授权可以在「设置 › Mio › 已授权的模型」撤销。

执行方式、步数上限、撤销规则见 Mio 介绍。

连接生成服务

真实生成默认关闭,第一次试用可以先用「本地模拟」跑通流程。模拟画面带 SIMULATED MOCK 标识,不会按提示词生成真实内容。

需要真实生成时,在「设置 › 模型与服务」添加连接。每个连接有独立的地区和密钥,同一服务商的多个账号互不影响。

类型可连接
视频火山方舟 Seedance、Google Veo、MiniMax、Vidu、可灵、通义万相,以及兼容服务(HTTPS)
图片OpenAI、兼容服务,以及本机的 ComfyUI

生成服务可能按用量计费,费用计入你在该服务商的账户。付费生成默认需要逐次确认;停止等待不保证服务商取消请求或退款。结果未知时,先在任务中心核对,不要重复提交。

备份与恢复

项目默认保存在本机。正常打开和关闭项目时,Mioon 会尝试自动备份发生变化的项目,通常保留最近三份有效副本。

  • 备份只包含 .mioon 项目文件。素材、版本、Mio 对话和任务需要另行保管。
  • 恢复会创建新项目并保留原项目。新项目仍引用原媒体,已经删除的媒体无法通过项目备份找回。
  • 本版需要手动更新。更新前先保管项目文件、素材及需要的本机记录,正常退出 Mioon,再安装新版本。

恢复方式见项目自动备份说明。

常见问题排查

遇到的情况先做什么
找不到工具或提示不是 FFmpegffmpeg 和 ffprobe 要选已解压、可执行的文件本身
能打开,但字幕、颜色或导出失败在「设置 › 视频工具」检查能力,多半是 FFmpeg 缺少滤镜,不是项目损坏
提示数据目录、权限或锁有问题保留原数据,不要删除数据库、令牌或锁文件来绕过
生成失败或结果未知保留原任务并查看详情,不要反复提交可能计费的同一操作

仍然无法解决,可以到 GitHub Issues 反馈,写明 Mioon 版本、系统、处理器、FFmpeg 版本、操作步骤和错误提示。截图前遮住密钥和私人内容。