本地 AI 绘画工具 Z-Image-Turbo UI 实测与使用指南
部署 AI 绘图工具常面临依赖配置繁琐、端口调试复杂的问题。Z-Image-Turbo 提供了一套开箱即用的本地解决方案,无需联网、不传图、不注册,双击启动后通过浏览器即可访问。完整可用的生产级 UI 支持中文提示词理解、实时预览及历史图库管理,模型全程运行在本地设备上。
1. 启动服务
1.1 执行启动脚本
镜像已预装全部依赖和模型文件,无需手动下载权重或配置 Python 环境。在终端中执行以下命令:
python /Z-Image-Turbo_gradio_ui.py
命令运行后,终端会持续输出日志。关键信息如下:
Running on local URL: http://127.0.0.1:7860
当这行文字稳定显示,并出现 Gradio 标准的启动横幅时,说明模型加载成功。首次启动约需 30–60 秒(模型加载至显存),后续重启通常在 10 秒内完成。若长时间卡在'Loading model…'状态,请检查 GPU 显存是否充足(建议≥8GB)。
1.2 验证服务状态
可通过以下方式确认服务是否正常响应:
- 按
Ctrl+C停止服务,再重新运行命令观察启动速度; - 使用
curl测试接口连通性:
curl -I http://127.0.0.1:7860
若返回 HTTP/1.1 200 OK,即表示 Web 服务已健康运行。
2. 访问界面
2.1 直接输入地址
打开任意现代浏览器(Chrome、Edge、Firefox 等),在地址栏输入:
http://localhost:7860
或等价写法:
http://127.0.0.1:7860
回车后页面将自动加载主界面。整个过程无需网络连接,静态文件均由本地服务提供。
2.2 点击终端链接
启动日志中的 http://127.0.0.1:7860 通常以可点击的蓝色超链接形式呈现。直接单击该链接,浏览器将自动打开 UI 界面。这是最快捷的启动路径,尤其适合远程 SSH 连接场景。
注意:如果点击无反应,请确认是否误输为
https://(应为http://);是否在容器内运行却尝试从宿主机访问(需确保端口映射正确,如-p 7860:7860);是否有防火墙拦截本地回环地址。
3. 界面功能概览
进入 UI 后,操作面板主要由三部分构成:
3.1 文生图输入区
核心创作入口,包含:
- Prompt(正向提示词):支持中文,例如:'一只橘猫坐在窗台,阳光洒落,写实风格'
- Negative Prompt(反向提示词):用于排除不想要的内容,例如:'模糊,畸变,多只猫,水印'
- Generate(生成按钮):点击即触发推理
3.2 参数调节区
点击右上角齿轮图标展开。关键参数含义如下:
- Resolution(图像尺寸):推荐从
768×1024或1024×768起步 - Sampling Steps(采样步数):日常使用 步足够

