Z-Image-Turbo_UI 部署与 WebUI 使用指南
1. 引言：开启 AI 图像生成的极简时代
随着 AI 生成技术的快速发展，高质量图像的创作门槛正在迅速降低。Z-Image-Turbo_UI 作为一款集成了先进生成模型与可视化交互界面的工具，正成为设计师、内容创作者和 AI 爱好者的新宠。它不仅具备亚秒级图像生成能力，还通过直观的 WebUI 设计，让非技术人员也能轻松上手。
本文将基于实际部署流程，全面展示 Z-Image-Turbo_UI 的真实使用效果，涵盖服务启动、界面操作、图像管理等核心环节，并结合命令行操作，帮助用户快速掌握其使用方法。
2. 启动服务与模型加载
2.1 执行启动命令
在完成环境部署后，首先需要运行主程序以加载模型并启动本地服务。具体命令如下：
python /Z-Image-Turbo_gradio_ui.py
该脚本会初始化模型参数、加载预训练权重，并启动基于 Gradio 框架的 Web 服务。执行后，终端将输出一系列日志信息，包括模型结构加载进度、设备检测结果（如 GPU 可用性）以及最终的服务监听地址。
2.2 确认模型加载成功
当控制台出现类似以下输出时，表示模型已成功加载并准备就绪：
Running on local URL: http://127.0.0.1:7860 Startup time: 45s Model loaded successfully with FP16 precision.
此时可通过浏览器访问指定地址进入 UI 界面。这一过程通常耗时 1 分钟以内，具体时间取决于硬件配置和模型大小。
提示：若出现 CUDA out of memory 错误，请尝试降低批处理尺寸或关闭其他占用显存的应用。
3. 访问与使用 WebUI 界面
3.1 两种访问方式
系统提供两种便捷途径进入图形化操作界面：
方法一：手动输入地址
在本地或远程设备的浏览器中输入：
http://localhost:7860/
即可打开 UI 主页面。适用于所有标准网络环境。
方法二：点击快捷链接
部分平台会在服务启动后自动生成可点击的 HTTP 链接（通常显示为蓝色超文本），直接点击即可跳转至 UI 界面。
3.2 UI 界面功能概览
Z-Image-Turbo_UI 采用模块化布局，主要区域包括：
- 提示词输入区：支持中英文混合描述，语义理解能力强
- 参数调节面板：可设置图像分辨率、采样步数、CFG 值等
- 生成控制按钮：一键触发图像合成任务
- 预览窗口：实时显示生成结果及历史记录缩略图
界面响应迅速，平均生成延迟低于 1 秒（512×512 图像），适合高频次创意探索。
4. 图像生成与历史管理
4.1 查看历史生成图像
所有输出图像默认保存在以下路径：
~/workspace/output_image/
可通过命令行列出全部文件：
ls ~/workspace/output_image/
输出示例：
image_20250405_142312.png image_20250405_142501.png image_20250405_142345.png image_20250405_142633.png
