admin9webs
86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
---
|
||
name: gs1-flux
|
||
description: 调用 GS-1 (192.168.9.113) ComfyUI FLUX.1-dev 图像生成 — txt2img/img2img/填充。GGUF Q5_K_S 模型,V100 双卡。触发:FLUX 出图、高质量图片、复杂构图、产品图、图生图、局部重绘、inpaint。
|
||
version: 1.0.0
|
||
author: 9Webs
|
||
license: internal
|
||
platforms: [linux]
|
||
triggers:
|
||
- FLUX
|
||
- flux1
|
||
- 高质量出图
|
||
- ComfyUI
|
||
- inpaint
|
||
- 局部重绘
|
||
- 图生图
|
||
---
|
||
|
||
# GS-1 FLUX.1-dev 图像生成 (ComfyUI API)
|
||
|
||
用 GS-1 的 ComfyUI + FLUX.1-dev (GGUF Q5_K_S) 生成高质量图片。直连 `192.168.9.113:8188` 即可。
|
||
|
||
## 服务拓扑
|
||
|
||
| 项 | 值 |
|
||
|----|----|
|
||
| 节点 | GS-1 = 192.168.9.113 (2× Tesla V100-SXM2-16GB) |
|
||
| ComfyUI | `http://192.168.9.113:8188` (v0.25.0) |
|
||
| UNet | `flux1-dev-Q5_K_S.gguf` (GGUF, V100 无 bf16 用 Q5) |
|
||
| 填充模型 | `flux1-fill-dev-Q5_K_S.gguf` (inpaint/局部重绘) |
|
||
| CLIP | `t5-v1_1-xxl-encoder-Q5_K_M.gguf` + `clip_l.safetensors` (type=flux) |
|
||
| VAE | `ae.safetensors` |
|
||
|
||
## 调用方式 (ComfyUI REST API)
|
||
|
||
1. **POST `/prompt`** 提交 API 格式工作流 (见 workflows/flux_txt2img.json),返回 `prompt_id`
|
||
2. **轮询 `GET /history/{prompt_id}`** 直到 `status.completed == true`
|
||
3. **取图 `GET /view?filename=<name>&type=output`** 下载 PNG
|
||
|
||
### 参考参数 (已实测)
|
||
|
||
- **steps 20** (18-28 均可;GGUF 量化,步数低会糊)
|
||
- **cfg 1.0** (FLUX 用 cfg≈1 + guidance;标准 KSampler 下 cfg 1.0 即可)
|
||
- **1024×1024** (FLUX 原生;V100 16GB 上限约 1024,超高会 OOM)
|
||
- **sampler `euler` / scheduler `simple`**, seed 可固定
|
||
- **耗时约 100-120 秒/张** (V100 无 flash-attention;首次调用含模型加载更慢)
|
||
|
||
### 脚本 (scripts/flux_txt2img.py)
|
||
|
||
```bash
|
||
python3 ~/.hermes/skills/gs1-flux/scripts/flux_txt2img.py "prompt here" [--steps 20] [--seed -1]
|
||
# 输出: /tmp/flux_out/flux_*.png
|
||
```
|
||
|
||
## 健康检查
|
||
|
||
```bash
|
||
curl -s http://192.168.9.113:8188/system_stats | head -c 200 # 返回 JSON = 正常
|
||
curl -s http://192.168.9.113:8188/object_info/UnetLoaderGGUF | grep -o 'flux1[^"]*' # 模型在位
|
||
curl -s http://192.168.9.113:8188/queue | python3 -c "import json,sys; d=json.load(sys.stdin); print('running:', len(d['queue_running']), 'pending:', len(d['queue_pending']))"
|
||
```
|
||
|
||
## 排障
|
||
|
||
- **提交 400** → 工作流节点错误,读 `node_errors` 详情 (常见: CLIPTextEncodeFlux 需 clip_l/t5xxl/guidance 三个输入)
|
||
- **长时间不出图** → 查队列 `queue` 是否堆积;单实例顺序执行,批量任务排队
|
||
- **OOM** → 降到 768×768 或减少 batch
|
||
- **换风格/复杂提示** → FLUX 对提示词敏感,直接写详细英文描述;负向提示基本不需要
|
||
|
||
## 服务端排障
|
||
|
||
```bash
|
||
sshpass -p 'Tt123456!' ssh admin9webs@192.168.9.113 'systemctl --user status comfyui* --no-pager | head -20'
|
||
```
|
||
|
||
## 陷阱
|
||
|
||
1. **Q5_K_S 量化**:图片质量略低于 fp8/bf16,但 V100 无 bf16 只能跑 GGUF;复杂文字/人脸注意检查。
|
||
2. **每次约 2 分钟**:批量任务要轮询串行,不要并发提交同实例。
|
||
3. **图片在 ComfyUI output 目录** (`~/ComfyUI/output/`),推荐客户端用 /view 下载,不依赖服务端目录。
|
||
4. **Flux Fill** (flux1-fill-dev) 用于局部重绘/inpaint,需配合 mask 工作流。
|
||
|
||
## 相关
|
||
|
||
- SDXL 出图用 `gs2-sdxl` 技能 (GS-2 :7861/:7862,快但质量略低)
|
||
- 配图策略: 快速草图用 SDXL,最终成品/复杂构图用 FLUX
|