ComfyUI 자동 업스케일
ComfyUI가 이미지 생성을 완료한 후, 순수 표준 라이브러리 파이썬 스크립트를 사용하여 이미지를 자동으로 업스케일합니다. 내장된 무한 루프 방지 및 해상도 보호 기능이 포함되어 있습니다.
필수 조건 및 사전 점검
먼저 항상 ComfyUI 연결 상태를 확인하고 설치된 업스케일 모델을 확인하세요:
python scripts/upscale_image.py --check --server http://127.0.0.1:8188
- ComfyUI가 다른 호스트나 포트에서 실행 중인 경우
--server http://<host>:<port>를 전달하세요. 설치된 업스케일 모델아래에 반환된 설치된 모델을 확인하세요. 사용자가 모델을 지정하지 않으면 스크립트는 가장 적합한 설치 모델을 자동 선택합니다(4x-UltraSharp.pth,RealESRGAN_x4plus.pth등을 선호).- 목록이 비어 있고 사용자가 기본 제공 모델 업스케일을 원하는 경우,
.pth/.safetensors업스케일 모델을ComfyUI/models/upscale_models/에 넣거나 사용자 정의--workflow를 제공하도록 안내하세요.
모드 1: 요청 시 업스케일링
사용자가 이미 생성된 이미지를 즉시 업스케일하려는 경우 upscale_image.py를 사용하세요.
ComfyUI 기록에서 최신 생성 이미지 업스케일
# 가장 최근의 업스케일되지 않은 단일 이미지 업스케일
python scripts/upscale_image.py --latest
# 최신 생성 이미지 4개를 업스케일하고, 4x 출력을 0.5로 축소하여 선명한 2x 결과 생성
python scripts/upscale_image.py --latest 4 --scale-by 0.5
# 특정 설치 모델을 사용하고 로컬 복사본도 저장
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out
특정 로컬 이미지 또는 폴더 업스케일
# 단일 또는 여러 파일
python scripts/upscale_image.py --image path/to/gen_0001.png
# 디렉토리 내 모든 업스케일되지 않은 이미지 배치 업스케일
python scripts/upscale_image.py --dir path/to/ComfyUI/output
실행 전 미리보기 (검증)
--dry-run(및 구조화된 출력을 위해 선택적으로 --json)을 사용하여 대상 이미지, 치수 및 모델 선택을 확인하세요. ComfyUI에 대기열을 추가하지 않습니다:
python scripts/upscale_image.py --latest --dry-run --json
모드 2: 자동 생성 후 감시자
ComfyUI가 이미지 생성을 완료한 직후 모든 새 이미지를 자동으로 업스케일하는 백그라운드 데몬을 실행하려면 watch_upscale.py를 사용하세요.
run_command를 통해 감시자를 시작할 때는IsDaemon: true로 설정하여 사용자가 ComfyUI에서 이미지를 생성하는 동안 백그라운드에서 계속 실행되도록 하세요.
옵션 A: ComfyUI API 감시 (권장 — 로컬 및 원격 모두 작동)
# websocket-client가 설치된 경우 WebSocket을 자동 사용하고, 그렇지 않으면 가벼운 /history 폴링으로 대체
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188
# 순수 표준 라이브러리 HTTP 폴링을 1.5초 간격으로 강제 사용, 사용자 지정 접두사 및 2x 대상 출력
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"
옵션 B: 로컬 출력 디렉토리 감시
python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188
재사용 가능한 구성
config.example.json을 로컬 구성 파일(예: my_upscale_config.json)에 복사하고 --config my_upscale_config.json을 두 스크립트 중 하나에 전달하세요. CLI 플래그는 항상 구성 파일 값을 재정의합니다.
사용자 정의 워크플로우 (Ultimate SD Upscale, Tiled Diffusion, SUPIR 등)
기본 제공 모드 업스케일러 대신 사용자 정의 ComfyUI 업스케일/고해상도 수정 워크플로우를 사용하려면:
python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1
API 형식 JSON 내보내기, 여러 LoadImage 노드 처리 및 문제 해결에 대해서는 references/custom-workflows.md를 참조하세요.
내장 안전 장치
- 무한 루프 방지:
- 제출된 모든 업스케일 작업은
extra_data.auto_upscale_generated = true로 태그가 지정되고prompt_id로 추적됩니다. - 출력은
upscaled/아래에 저장되며(기본적으로filename_prefix = "upscaled/upscaled"), 두 스크립트 모두upscaled/디렉토리 또는upscaled_접두사와 일치하는 이미지를 자동으로 무시합니다.
- 제출된 모든 업스케일 작업은
- OOM / 과도 업스케일 방지:
- 가장 긴 변이
--max-input-side(기본값2048px)를 초과하는 이미지는 자동으로 건너뜁니다. 비활성화하려면--max-input-side 0을 전달하세요.
- 가장 긴 변이
- 감시자 시작 시 소급 플러드 방지:
watch_upscale.py는 시작 시 기존 ComfyUI 기록/폴더 내용을 스냅샷하고 이후에 생성된 새로운 이미지만 처리합니다.
확인
- 요청 시 실행의 경우, 명령이 종료 코드
0으로 종료되고[UPSCALED] <source> -> upscaled/...를 출력하는지 확인하세요. - 감시자 실행의 경우, 빠른
--once --dry-run테스트를 실행하거나 데몬 로그에서Waiting for new images...를 확인하고, ComfyUI에서 하나의 이미지를 생성하면 재트리거 없이 정확히 하나의[Upscaled OK]항목이 트리거되는지 확인하세요.