在 Jetson Orin NX 上一键部署 Z-Image-Turbo HTTP API 进行本地文生图和图生图。
| 设备 | 用途 |
|---|---|
| NVIDIA Jetson Orin NX (16GB) | 运行 Z-Image-Turbo 模型 |
部署后你将获得：
前提条件： Jetson Orin NX 16GB + JetPack 6 + NVIDIA Docker 运行时 + 网络连通（首次部署自动下载模型）。
将 Z-Image-Turbo API 容器部署到 Jetson。
通过 SSH 一键部署到你的 Jetson Orin NX。
nvidia/home/nvidia/models存放模型权重和 TRT 引擎的目录（见前提条件）
512/home/nvidia/z-image-output生成的图片保存在此目录
| 问题 | 解决方案 |
|---|---|
| SSH 连接失败 | 检查 IP、用户名、密码，确认 Jetson SSH 服务已启用 |
| 找不到 Docker | 在 Jetson 上安装 Docker 和 NVIDIA Container Toolkit |
| HuggingFace 下载失败 | 脚本会自动切换到 hf-mirror.com；若两者都不通，请在 Jetson 上配置代理或手动把模型文件放进模型根目录 |
| 下载中断 | 重新部署即可 —— 未完成的 .part 文件会丢弃，已下载完成的文件不会重复下载 |
| API 无响应 | 检查容器日志：docker logs z-image-api |
| Docker 权限不足 | 运行 sudo usermod -aG docker <user> 并重新登录 |
http://<jetson-ip>:8000/health输入提示词来生成图片。每次生成需要 1-2 分钟。生成结果会直接显示在验证面板中。
| 问题 | 解决方案 |
|---|---|
| 健康检查失败 | 确认 Jetson 可达且端口 8000 未被防火墙拦截 |
| 生成返回错误 | 查看容器日志：docker logs z-image-api |
| 请求超时 | 生成需要 1-2 分钟，将 HTTP 客户端超时时间增加到 180 秒 |
Z-Image-Turbo 已成功部署到你的 Jetson 上。
curl http://<jetson-ip>:8000/health
curl -X POST http://<jetson-ip>:8000/generate_json -H 'Content-Type: application/json' -d '{"prompt": "一只可爱的猫，照片级真实感", "num_steps": 4}'
curl -X POST http://<jetson-ip>:8000/generate -F 'prompt=一只戴着红围巾的猫' -F 'image=@/path/to/reference.png' -F 'num_steps=8' -F 'strength=0.65'
{"success": true}