Z-Image-Turbo邮件提醒功能：长时间任务异步通知部署方案
1. Z-Image-Turbo_UI界面简介
Z-Image-Turbo 不仅是一个高效的图像生成模型，还配备了直观易用的图形化操作界面（UI），让用户无需编写代码也能轻松完成图像生成任务。整个UI设计简洁明了，功能模块划分清晰，支持参数调节、图像预览、历史记录查看等核心操作。对于需要长时间运行的图像生成任务，传统方式往往要求用户持续等待或手动刷新页面确认进度，体验较差。为此，Z-Image-Turbo 引入了邮件提醒功能，能够在任务完成或出错时自动发送通知，实现真正的异步处理与无人值守运行。
这一功能特别适用于批量生成高分辨率图像、复杂风格迁移或定时任务调度等场景。用户提交任务后即可离开，系统会在后台完成处理，并通过邮箱告知结果，极大提升了使用效率和便捷性。
2. 本地访问与基础使用流程
2.1 启动服务并加载模型
在部署完成后，首先需要启动 Z-Image-Turbo 的 Gradio 服务以加载模型并开启 Web 界面。打开终端，执行以下命令：
python /Z-Image-Turbo_gradio_ui.py当命令行输出中出现类似Running on local URL: http://127.0.0.1:7860的提示信息时，说明服务已成功启动，模型也已完成加载。此时，系统已经准备好接收图像生成请求。
如上图所示，这是典型的启动成功界面，包含本地访问地址、网络状态以及部分日志信息。
2.2 访问 UI 界面进行图像生成
服务启动后，可以通过浏览器访问 UI 界面开始使用。
方法一：直接输入地址
在任意浏览器中输入以下地址即可进入主界面：
http://localhost:7860/该地址是默认的本地服务端口，只要服务正常运行，就能看到完整的 Z-Image-Turbo 操作面板。
方法二：点击启动后的链接按钮
某些环境下，Gradio 会自动生成可点击的 HTTP 链接（通常显示为“Launch”或“Public Link”下方的http://127.0.0.1:7860）。直接点击该链接即可跳转至 UI 页面。
进入界面后，你可以设置图像尺寸、选择风格模板、调整采样步数和提示词（prompt）等参数，然后点击“生成”按钮提交任务。对于耗时较长的任务，建议启用邮件提醒功能，避免长时间挂机等待。
3. 邮件提醒功能配置详解
为了让用户在任务完成后第一时间获知结果，Z-Image-Turbo 支持集成 SMTP 邮件服务，在图像生成结束或发生错误时自动发送通知邮件。以下是详细配置步骤。
3.1 开启邮件功能的前提条件
要使用邮件提醒功能，需准备以下信息：
- 一个可用的邮箱账号（推荐使用 QQ 邮箱、163 邮箱或 Gmail）
- 该邮箱的SMTP 服务已开启
- 获取 SMTP 服务器地址、端口、用户名和授权码（非登录密码）
以 QQ 邮箱为例：
- SMTP 服务器：
smtp.qq.com - 端口：
587（TLS 加密） - 用户名：你的QQ邮箱地址
- 密码：在邮箱设置中开启SMTP后生成的“授权码”
注意：请勿将真实密码用于程序配置，务必使用邮箱平台提供的第三方应用专用授权码。
3.2 修改配置文件启用邮件通知
找到项目根目录下的config.yaml或settings.py文件（具体名称视部署版本而定），添加或修改如下字段：
email_notification: enable: true smtp_server: smtp.qq.com smtp_port: 587 username: your_email@qq.com password: your_authorization_code recipient: target_email@example.com sender_name: Z-Image-Turbo System保存文件后重启服务，确保配置生效。
3.3 在 UI 中触发带提醒的任务
目前邮件提醒功能可通过两种方式触发：
- 在UI界面勾选“完成时发送邮件”选项（如有提供）
- 通过API调用时附加 notify_email 参数
例如，使用 curl 调用 API 并附带邮箱通知请求：
curl -X POST "http://127.0.0.1:7860/api/generate" \ -H "Content-Type: application/json" \ -d '{ "prompt": "a futuristic city at night, neon lights, raining", "size": "1024x1024", "notify_email": "user@example.com" }'一旦任务完成，系统将自动连接 SMTP 服务器，发送一封包含任务状态、生成时间及输出路径的摘要邮件。
3.4 邮件内容示例
收到的邮件标题可能为：
【Z-Image-Turbo】图像生成任务已完成正文内容大致如下：
您好， 您的图像生成任务已于 2025-04-05 14:32 完成。 - 提示词：a futuristic city at night, neon lights, raining - 图像尺寸：1024x1024 - 耗时：186秒 - 输出路径：/root/workspace/output_image/20250405_143024.png 您可以前往本地目录查看生成结果，或通过共享文件夹下载。 感谢使用 Z-Image-Turbo！ —— 系统自动通知若任务失败，邮件也会明确指出错误类型，如显存不足、参数错误等，帮助快速排查问题。
4. 历史图像管理操作指南
除了异步通知外，合理管理生成的历史图像也是提升工作效率的重要环节。Z-Image-Turbo 默认将所有输出图像保存在~/workspace/output_image/目录下，便于后续查看、清理或批量导出。
4.1 查看历史生成图像
在终端中运行以下命令，列出所有已生成的图片文件：
ls ~/workspace/output_image/系统将返回类似以下的文件列表：
20250405_143024.png 20250405_141502.png 20250405_135611.png每个文件名按时间戳命名，格式为YYYYMMDD_HHMMSS.png，方便追溯生成时间。
你也可以结合find命令按日期筛选：
# 查找今天生成的所有图像 find ~/workspace/output_image/ -name "$(date +%Y%m%d)*.png"4.2 删除历史图像释放空间
随着任务增多，输出目录可能会积累大量图像，占用较多磁盘空间。可根据需要删除单个或全部文件。
进入输出目录：
cd ~/workspace/output_image/删除指定图片：
rm -rf 20250405_141502.png清空所有历史图像：
rm -rf *建议：在执行清空操作前，先备份重要成果或将常用图像归档到其他位置。
此外，可编写简单的脚本实现自动清理超过7天的旧文件：
#!/bin/bash # 自动删除7天前的图像 find ~/workspace/output_image/ -name "*.png" -mtime +7 -delete将其加入 crontab 实现定期执行：
# 每周日凌晨2点执行清理 0 2 * * 0 /path/to/cleanup_script.sh5. 总结
Z-Image-Turbo 的邮件提醒功能为长时间图像生成任务提供了强有力的异步支持。通过简单的 SMTP 配置，用户可以在提交任务后立即脱机，由系统在完成后主动推送结果通知，显著提升使用体验和资源利用率。配合清晰的 UI 界面和灵活的本地访问方式（http://127.0.0.1:7860），即使是初学者也能快速上手。
同时，通过对output_image目录的查看与管理，可以有效组织生成内容，避免数据混乱。无论是个人创作还是团队协作，这套“提交—等待—通知—获取”的闭环流程都大大优化了AI图像生产的整体效率。
未来还可进一步扩展此功能，例如支持微信/钉钉推送、多收件人通知、生成报告附件等功能，让 Z-Image-Turbo 成为更智能、更贴心的视觉创作助手。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
