admin9webs
107 lines
4.4 KiB
Markdown
107 lines
4.4 KiB
Markdown
---
|
||
name: gs2-sdxl
|
||
description: 调用 GS-2 (192.168.9.116) Forge SDXL base 1.0 图像生成 API — txt2img/img2img,双实例 :7861/:7862 轮询。触发:生成图片/产品图/配图/场景图,SDXL 出图,文生图,图生图。
|
||
---
|
||
|
||
# GS-2 SDXL 图像生成 (Forge API)
|
||
|
||
用 GS-2 的 SDXL base 1.0 生成图片。本机(任意节点)直连 `192.168.9.116` 即可,无需代理。
|
||
|
||
## 服务拓扑
|
||
|
||
| 项 | 值 |
|
||
|----|----|
|
||
| 节点 | GS-2 = 192.168.9.116 (2× RTX 3060 Laptop 12GB) |
|
||
| 实例1 | `http://192.168.9.116:7861` (GPU0, systemd `forge-sdxl.service`) |
|
||
| 实例2 | `http://192.168.9.116:7862` (GPU1, systemd `forge-sdxl-2.service`) |
|
||
| 模型 | `sd_xl_base_1.0.safetensors` — **完整 SDXL base,不是 turbo!** + `sdxl_vae.safetensors` |
|
||
| API | 标准 A1111/Forge: `/sdapi/v1/txt2img`, `/sdapi/v1/img2img`, `/sdapi/v1/sd-models` |
|
||
|
||
双实例轮询:优先 7861,失败/繁忙换 7862。
|
||
|
||
## 推荐参数 (SDXL base 完整版,2026-08-27 实测)
|
||
|
||
⚠️ 模型是完整 base(非 turbo),**steps 需要 24-30**,2 步会出糊图。
|
||
|
||
| 参数 | 值 |
|
||
|------|----|
|
||
| steps | 24-30 (出图约 10-25s@1024²) |
|
||
| cfg_scale | 6-7.5 |
|
||
| width/height | 768~1024 (SDXL 原生尺寸),默认 1024×1024 或 832×1216 |
|
||
| sampler_name | `euler_a` 或 `dpmpp_2m_karras` |
|
||
| negative_prompt | `lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, cropped, worst quality, low quality, jpeg artifacts, signature, watermark, username, blurry` |
|
||
| 并发 | 单实例同时只处理 1 个请求 (12GB VRAM),批量任务轮询双实例 |
|
||
|
||
## 调用方式 (已验证)
|
||
|
||
### curl txt2img
|
||
|
||
```bash
|
||
curl -s -X POST http://192.168.9.116:7861/sdapi/v1/txt2img \
|
||
-H 'Content-Type: application/json' \
|
||
-d '{"prompt":"a cute corgi wearing sunglasses, studio photo","negative_prompt":"lowres, blurry, watermark","steps":24,"cfg_scale":7,"width":1024,"height":1024,"sampler_name":"euler_a","seed":-1}'
|
||
```
|
||
|
||
### Python (urllib,无 curl 依赖)
|
||
|
||
```python
|
||
import json, base64, urllib.request
|
||
|
||
def sdxl_txt2img(prompt, negative_prompt="", steps=24, cfg=7.0,
|
||
w=1024, h=1024, sampler="euler_a", seed=-1, port=7861):
|
||
req = urllib.request.Request(
|
||
f"http://192.168.9.116:{port}/sdapi/v1/txt2img",
|
||
data=json.dumps({"prompt": prompt, "negative_prompt": negative_prompt,
|
||
"steps": steps, "cfg_scale": cfg, "width": w, "height": h,
|
||
"sampler_name": sampler, "seed": seed}).encode(),
|
||
headers={"Content-Type": "application/json"})
|
||
with urllib.request.urlopen(req, timeout=180) as r:
|
||
data = json.loads(r.read())
|
||
return base64.b64decode(data["images"][0]) # PNG bytes
|
||
|
||
# 保存
|
||
png = sdxl_txt2img("a red apple on a wooden table, product photo", port=7861)
|
||
open("/tmp/apple.png", "wb").write(png)
|
||
```
|
||
|
||
### img2img (重绘/换风格/局部重绘)
|
||
|
||
```bash
|
||
curl -s -X POST http://192.168.9.116:7862/sdapi/v1/img2img \
|
||
-H 'Content-Type: application/json' \
|
||
-d '{"init_images":["<base64 PNG>"],"prompt":"same product, luxury studio background","denoising_strength":0.6,"steps":24,"cfg_scale":7,"width":1024,"height":1024,"sampler_name":"euler_a"}'
|
||
```
|
||
|
||
要点:
|
||
- `init_images` 传 **base64 编码的 PNG 字符串**(无 data: 前缀)
|
||
- `denoising_strength` 0.5-0.7 重绘风格,0.3 以下基本保留原图,0.8+ 大改
|
||
|
||
## 健康检查
|
||
|
||
```bash
|
||
# 模型列表 (返回 JSON 即服务正常)
|
||
curl -s http://192.168.9.116:7861/sdapi/v1/sd-models
|
||
# 实例间轮询: 7861 → 7862
|
||
```
|
||
|
||
## 服务端排障 (需要时)
|
||
|
||
```bash
|
||
sshpass -p 'Tt123456!' ssh admin9webs@192.168.9.116 \
|
||
'export XDG_RUNTIME_DIR=/run/user/$(id -u); systemctl --user status forge-sdxl forge-sdxl-2 --no-pager | head -30'
|
||
# 重启: systemctl --user restart forge-sdxl forge-sdxl-2
|
||
```
|
||
|
||
## 陷阱
|
||
|
||
1. **是 base 模型不是 turbo**:steps 必须 24+,2-4 步出糊图/灰图。
|
||
2. **双实例各绑一张卡**:单实例并发第 2 个请求会排队或 OOM,批量任务轮询两个端口。
|
||
3. **12GB VRAM 上限**:1024×1024 稳定;超 1024 或加 ControlNet 可能 OOM,降 768。
|
||
4. **seed=-1 随机**,固定 seed 可复现。
|
||
5. 服务端 outputs 目录在 GS-2 (`~/stable-diffusion-webui-forge/outputs/`),但**推荐客户端解析 base64 直接存本地**,不依赖服务端目录。
|
||
|
||
## 相关
|
||
|
||
- 部署/版本排障细节见本地 `gpustack-cluster` 技能 (GS-2 Forge 双实例 systemd 章节)
|
||
- FlairGS (AppServer-105 :7870) 也调这两个实例:FORGE_STEPS=24, CFG=7.5, denoise=0.70 (产品图场景生成)
|