AI Offline Studio
制作在拍照亭电脑上运行的 AI 照片模板,无需网络,不按张收费。
AI Offline Studio 直接在拍照亭电脑上把宾客照片变成新的 AI 图片。活动期间无需网络,也不按张收费,非常适合 Wi-Fi 不稳定的场地和宾客众多的活动。
AI Offline 还是 AI Online?
| AI Offline | AI Online | |
|---|---|---|
| AI 运行位置 | 拍照亭电脑 | 在线 AI 服务 |
| 活动现场网络 | 不需要 | 必需,而且要稳定 |
| 每张照片的费用 | 无 | 服务商按每次生成收费 |
| 硬件 | NVIDIA RTX 显卡 | 任何能运行 Q-Booth 的电脑 |
| 输出 | 图片(以及前后对比视频) | 图片和 AI 视频 |
AI Offline 在拍照亭电脑上运行模型;AI Online 在云端运行大得多的模型,效果明显更好。两者的对比:
- 文字生成图片(Imagine):AI Offline 做得非常好。
- 修改宾客的照片(Re-Imagine、Re-Imagine + Reference、Composite):效果不错,但不如 AI Online。要让结果与宾客照片或参考图片高度一致更难,需要写得好的提示词。换装一定会换掉服装,但与服装图片有多接近,取决于那张图片和服装的复杂程度,所以活动前请用真实照片测试。
- 结果必须与宾客或参考图一模一样时:AI Online 是更好的选择。如果脸必须完全不变,Face Swap 可以保留原脸。
- AI Offline 的优势:不需要网络,没有按张费用,所有内容都留在拍照亭电脑上。
- 速度取决于电脑。在状态良好、配备 RTX 4060 或更高显卡的台式机上,通常每张不到 20 秒。较旧的显卡(RTX 2060、3060)更慢。笔记本电脑生成时必须插着电源充电,否则会慢很多。把 Q-Booth 文件夹放在 SSD 上很有帮助,同时运行其他程序也会拖慢速度。更快的显卡让 AI Offline 更快,但结果的质量取决于模型,而不是显卡。
Pro 许可证也包含 AI Online(按次使用点数付费),所以可以为每个模板选择在线或离线。
使用要求
- 许可证:AI 模板(Imagine、Re-Imagine、Re-Imagine + Reference、Composite)需要 Pro 许可证。换脸 使用 Advanced 许可证也可以。Advanced 许可证在 AI Offline 中只能看到换脸模板:其他模板不会出现在模板列表和模板库中。Basic 许可证完全没有 AI Offline。
- 显卡:至少 8 GB 显存的 NVIDIA RTX 显卡。建议 8 核处理器和 16 GB 及以上内存。参见 系统要求。
- 磁盘空间:离线 AI 模型在应用之外还需要数十 GB 空间。
- GPU 包:要让换脸和人脸修复在显卡上运行,请在 设置 › 高级 › 计算设备 中下载 GPU 包。参见 高级设置。
AI Offline 服务器
AI 引擎随 Q-Booth 一起启动。它的状态显示在侧边栏底部的 AI Offline 服务器:
| 状态 | 含义 |
|---|---|
| 加载中 | 引擎正在启动,通常需要一到两分钟。 |
| 在线(绿色) | 已就绪,可以处理 AI 模板。 |
| 离线(红色) | 未运行,无法处理 AI 模板。 |

换脸不使用 AI Offline 服务器:即使状态为 离线 也能处理。其他所有 AI Offline 模板都需要状态为 在线,包含这类模板的 Collage、Lenticular 或 Motion 模板也一样。否则处理会停止并提示 "AI Offline server is not online. Check the sidebar status pill — it must be green before processing." 如果一直是红色,请先把 NVIDIA 驱动更新到最新版本并重启电脑,参见 服务器一直离线时。
把鼠标悬停在状态框上可查看完整状态。该状态框只在 Pro 许可证、且处于专家模式时显示:简易模式下会隐藏。Advanced 许可证没有它,因为换脸不使用服务器。
服务器日志窗口
双击 AI Offline 服务器 状态框会打开 服务器日志 窗口,显示引擎正在做什么。窗口中有 启动服务器 和 停止服务器,可手动启动或重启引擎,另有 复制日志、导出到文件 和 清除。关闭窗口只是把它隐藏,服务器会继续运行。(如果服务器设置为外部部署,则不显示启动和停止按钮。)
服务器一直离线时
打开 Q-Booth 后先等几分钟。如果状态框始终没有变绿:
- 首先把 NVIDIA 驱动更新到最新版本。这是最常见的原因。到 nvidia.com 下载适合您显卡的驱动(或在 NVIDIA App 中更新),安装后重启电脑。AI 引擎需要 580 或更高版本的驱动。要查看当前驱动版本,在命令提示符中输入
nvidia-smi:第一行的 “Driver Version” 就是版本号。 - 重新打开 Q-Booth,双击 AI Offline 服务器 状态框,按 启动服务器 并查看日志。
- 确认电脑确实配有 NVIDIA RTX 显卡,关闭其他占用资源的程序以释放内存,并确认安全软件没有拦截 Q-Booth。
- 只有在更新驱动后仍然显示 离线 时:在 服务器日志 窗口中按 导出到文件,把日志发给技术支持。
以前能用,但每次重启后都变成离线?如果 服务器日志 显示 “only one usage of each socket address” 或 “error while attempting to bind on address ('127.0.0.1', 8188)”,说明旧的 AI 引擎仍在后台运行,挡住了新的引擎。关闭 Q-Booth,打开任务管理器,结束所有 python.exe(或直接重启电脑),然后重新打开 Q-Booth,等待 在线。5.9.6.1 已修复:重启服务器时会先关闭旧引擎。
选择 AI 模板
- 打开 Studio › AI Offline(或在活动中使用 在 Studio 中创建 › AI Offline)。
- 点击中间面板顶部的 模板 按钮,打开 选择 AI 模板 对话框。
- 在列表中点击一个模板。右侧显示预览和详细信息:名称、版本、ID、模型、可用于 Event 和 描述。
- 点击 使用模板。如果有现成的示例,还会出现 加载示例 按钮:它会载入一个完整的示例模板,供您研究或修改。

AI 模板类型
| 模板 | 作用 | 需要宾客照片 |
|---|---|---|
| Face Swap | 把宾客的脸放进场景图片。详见单独的文章:换脸。 | 是 |
| Imagine | 仅凭文字生成图片。 | 否 |
| Re-Imagine | 按提示词改变宾客照片,同时保留他们的脸。大多数活动的首选。 | 是 |
| Re-Imagine + Reference | 与 Re-Imagine 相同,另加一张参考图片,让 AI 参照其风格、服装或构图。 | 是 |
| Composite | 把宾客放进您选择的背景,再用 AI 融合,让光线和边缘看起来自然。 | 是 |
Imagine 不能用于活动,因为没有可放入的宾客照片。活动编辑器会拒绝它,提示 "This template can't be used in an event. Only templates that take the captured photo as a source qualify…" 其他模板都可以用于活动。
选择模板会把 宽高比 重置为 自动,并把 质量 重置为该模板的默认值。
逐步制作 Re-Imagine 模板
- 确认 AI Offline 服务器 显示 在线。
- 在 选择 AI 模板 中选择 Re-Imagine。
- 在 源图片 中点击 选择图片,载入测试照片(相机、剪贴板、相册 或 文件)。
- 打开 提示词 选项卡,保持 基础,把提示词写成指令(见下方示例)。
- 用滑块设置 质量。
- 在左侧面板设置 宽高比。自动 保持照片原有形状。
- 按 处理 (F5)。稍等片刻结果就会出现;用 对比 检查。
- 在 叠加 中加相框,需要的话在 选项 中打开 前后对比视频。
- 在 Event 中填写 标题 和 封面图片,然后点击 保存。AI Offline 模板保存为
.qsd文件。

一个能保持宾客原样的提示词示例,适用于单人或多人:
Change the clothes of the people in this photo to elegant 1920s Great Gatsby evening wear, and change the background to an empty Art Deco ballroom with gold chandeliers, warm golden light and falling confetti. Keep the same people, the same number of people, their faces, poses and positions unchanged. Do not add anyone.
Re-Imagine 的提示词请写成指令(“更换服装……、更换背景……、保持相同的人……、不要添加任何人”)。纯描述式的提示词可能让 AI 多加人或改变脸部。更多建议见 如何写好 AI 提示词。
提示词选项卡
| 控件 | 作用 |
|---|---|
| 基础 | 所有宾客使用同一个固定提示词。 |
| 动态 | 带空格的提示词,由宾客回答问题来填写。用 动态提示词编辑器 制作(5.8.0.0 之前叫“提示词构建器”)。参见 动态提示词。 |
| 提示词库 | 您保存的提示词:选择一个使用,或把当前提示词存起来以后用。 |
| 提示词构建器 | 自 5.8.0.0 起,用于基础提示词:通过从列表中选择而不是打字来生成提示词。窗口、语言选择以及锁定 / 解锁 与 AI Online Studio 相同。只在需要提示词的模板上提供。这里没有参考图部分:在 AI Offline 中,参考图的用途由模板本身决定。 |
只有一个提示词框,没有单独的负向提示词框。选择 动态 时,提示词框显示只读预览;按处理(或宾客使用模板)时,会先弹出窗口提问。
质量
质量 滑块(中间面板,模板 下方)有四档:Low、Medium、Good 和 High。内置模板默认为 Good。它在速度和细节之间取舍。越高越好看,但耗时越长,而宾客正在拍照亭前等待。请选择等待时间仍可接受的最高质量,并在活动电脑上实际计时。
参考图片、引导图片和背景
根据模板不同,中间面板会出现额外的选项卡:
| 选项卡 | 放什么 |
|---|---|
| 参考图片 | Re-Imagine + Reference:AI 要参照其风格、服装或构图的图片。选项卡出现时即为必填。 |
| 引导图片 | Composite:带透明区域的 PNG,例如相框、道具或人物抠图。它会全幅叠在宾客上方,并保留在结果中(再由 AI 融合)。必须是 PNG 文件,因此只能从相册或文件选择(相机 和 剪贴板 无法保留透明区域)。选项卡出现时为必填。在 Studio 中拍照时,相机窗口会在实时画面上显示引导图,方便宾客对准姿势。 |
| 背景 | Composite:放入宾客的场景图片。必填。在其他模板上(自 5.6.0.2 起),此选项卡是对成品图片的额外处理:原始、移除背景 或 更换背景,并有与 Photo Studio 相同的 模型(标准 / 精细)和 描边 选项。 |
| 色彩校正 | 五个滑块调整最终效果,每个范围 -100 到 +100(0 = 不变):色温、色相、亮度、对比度、饱和度。 |
不要混淆 引导图片 和 背景:引导图片叠在宾客上方,会出现在结果中;背景则是宾客身后的场景。如果缺少必填图片,处理 和 保存 会提示需要填写哪个选项卡。
Composite
Composite 把宾客放进您的背景,并用 AI 融合和调整光线,可使用提示词、引导图片和色彩校正。旧的 Composite (Raw) 模板(只抠出宾客再叠上引导图和背景,不用 AI)已在 5.6.0.2 中移除。要得到这种效果,请使用 Photo Studio:背景 › 更换背景,再加上模式为 相机 + 结果 的 引导图。
输出选项
| 设置 | 作用 |
|---|---|
| 宽高比 | 结果的形状。自动 保持宾客照片的形状(Imagine 没有照片,则使用模板自己的默认形状)。选定形状后,拍照时相机窗口会显示该形状的引导框。 |
| 叠加 | 默认(设置中的全局叠加,在活动中则使用活动的叠加)、自定义(此模板专用相框)或 禁用。5.9.6.1 起,选 自定义 时,把照片放进相框的窗口里 开关会把结果放进相框的窗口内,而不是放在整个叠加层下面,AI 模板和 Face Swap 模板都适用;参见 把照片放进相框。包含原始照片 和 前后对比视频 的叠加也有同样的开关。 |
| 在结果中包含原始照片 | 除 AI 图片外,再把宾客的原始照片作为额外结果提供。开启后会出现该照片的 叠加 选项:禁用(默认)、默认(与结果相同的叠加)或 自定义。对 Imagine 无效。 |
| 前后对比视频 | 生成一段从宾客照片变成 AI 图片的短视频,非常适合分享到社交媒体。所有使用宾客照片的模板都可用,包括换脸;Imagine 不可用。设置见下文。 |
前后对比视频设置
- 照片停留:原始照片显示多久,0.5–6 秒(默认 1.5 秒)。
- 结果停留:AI 图片显示多久,0.5–6 秒(默认 2 秒)。
- 转场:Fade、Dissolve、Wipe Left、Slide Left 或 Circle Open。
- 叠加:视频自己的叠加,禁用、默认(与结果相同的叠加)或 自定义。

文件格式由模板决定;JPEG 和视频质量在 设置 › 其他 中为整个应用统一设置。
在活动中使用
- 专家模式:在活动中打开 模板,点击 打开文件 添加
.qsd;或点击 在 Studio 中创建 › AI Offline 直接制作,然后点击 保存并返回。 - 简易模式:AI Photo offline 卡片在一个对话框中完成同样的设置,先试一下 可以用一张照片测试。自 5.8.0.0 起,提示词框上方的 帮我生成提示词 会打开提示词构建器。
活动中,宾客选择模板并拍照;拍照亭电脑生成图片,结果像平常一样分享(例如通过二维码)。参见 模板 和 运行活动。
活动打开或运行时可能出现的提示:
| 提示 | 含义 |
|---|---|
| "Some templates use AI Offline and need the local AI engine, which is not ready." | 活动打开时 AI Offline 服务器尚未在线,在 Before You Start 中显示。请等待,或按 Start Anyway。如果始终不变绿,请先更新 NVIDIA 驱动(参见 服务器一直离线时)。 |
| "The local AI engine is still starting up. Please wait a moment and try again." | 服务器仍在启动时,宾客选择了 AI Offline 模板。 |
| "This template runs AI Offline Studio, but the local AI engine is not available on this computer. It needs a Pro license and an NVIDIA RTX graphics card." | 这台电脑没有 AI 引擎(不是 Pro,或没有 RTX 显卡)。 |
| "This template uses Face Swap, which needs an Advanced license or higher." | Basic 许可证上使用了换脸模板。 |
常见问题
服务器一直显示“加载中”或“离线”(红色)。
Q-Booth 启动后请等一到两分钟。如果仍未变成 在线:
- 首先把 NVIDIA 驱动更新到最新版本(580 或更高),可从 nvidia.com 或 NVIDIA App 更新,然后重启电脑。这是最常见的原因。在命令提示符中运行
nvidia-smi,第一行的 “Driver Version” 显示版本号。 - 打开 Q-Booth,双击 AI Offline 服务器 状态框,按 启动服务器 并查看日志。
- 确认电脑配有 NVIDIA RTX 显卡且内存充足(关闭其他占用资源的程序),并确认安全软件没有拦截 Q-Booth。
- 只有在更新驱动后仍然离线时:用 导出到文件 导出日志发给技术支持。
另见 故障排除。
每次重启后服务器都离线(“only one usage of each socket address”)。
旧的 AI 引擎仍在后台运行,挡住了新的引擎。关闭 Q-Booth,打开任务管理器,结束所有 python.exe(或直接重启电脑),然后重新打开 Q-Booth,等待 在线。5.9.6.1 已修复:重启服务器时会先关闭旧引擎。
按处理时提示 “AI Offline server is not online”。
等待侧边栏底部出现绿色的 在线。如果一直是红色,请先把 NVIDIA 驱动更新到最新版本并重启电脑,然后双击状态框 › 启动服务器。完整步骤见 服务器一直离线时。
“此 AI Offline 模板需要 Pro 许可证才能运行。”
Imagine、Re-Imagine、Re-Imagine + Reference 和 Composite 需要 Pro 许可证。Advanced 许可证只能使用换脸。
看不到 AI Offline 服务器状态框。
许可证不是 Pro,或应用处于简易模式。
"The template '…' this file was saved with is no longer installed."
该 .qsd 是用这台电脑上没有的 AI 模板制作的。请用已安装的模板重新制作。
Composite (Raw) 去哪了?
它已在 5.6.0.2 中移除。请在 Photo Studio 中用 更换背景 加上模式为 相机 + 结果 的 引导图 实现同样效果。
活动中的处理速度比在 Studio 中慢很多。
活动期间相机和活动界面也会占用内存。请降低 质量、关闭其他程序,并且一定要在启动活动的状态下计时测试,而不只是在 Studio 中测试。
结果多出了人或改变了脸。
把提示词改写成指令,并在结尾加上 “Keep the same people, the same number of people, their faces, poses and positions unchanged. Do not add anyone.” 如果脸必须完全不变,请改用 Face Swap 或 AI Online(参见 AI Offline 还是 AI Online?)。
处理或保存被阻止,提示“此模板需要一张引导图片”(或参考图片 / 背景图片)。
打开提示中所说的选项卡并选择图片。引导图片必须是 PNG 文件。
三个要点
- 提前打开 Q-Booth,等服务器显示 在线。
- 选择宾客能接受等待时间的质量。
- 开场前,在活动中用真实照片测试每个模板。
下一步
仍需要帮助?
我们的团队在 WhatsApp 上为您解答。请告知 Q-Booth 版本及屏幕上显示的内容。