# Qwen-Image-Edit-2511 (이미지 모델)

> Qwen-Image-Edit-2511을 로컬에서 실행합니다. 지시문으로 이미지를 최고 품질(20 스텝)로 편집할 수 있습니다. 텍스트, 색상, 재질, 사물을 바꾸거나 최대 4장의 이미지를 합성하세요. Apache-2.0 라이선스로 상업적 사용이 허용됩니다. NVIDIA GPU 16 GB 이상과 RAM 32 GB가 필요합니다.

- Id: `aigd.image-qwen-image-edit-2511`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 이미지 모델
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.1.1 (2026-11-22 게시)
- 라이선스: Apache-2.0
- AI Game Dev 앱 필요: `>=0.25.0`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.image-qwen-image-edit-2511

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.image-qwen-image-edit-2511
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.image-qwen-image-edit-2511`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.1.1 | 2026-11-22 | `>=0.25.0` | 최신 |
| 1.1.0 | 2026-11-18 | `>=0.25.0` | - |
| 1.0.3 | 2026-11-06 | `>=0.25.0` | - |
| 1.0.2 | 2026-10-13 | `>=0.25.0` | - |
| 1.0.1 | 2026-10-12 | `>=0.25.0` | - |

## 설명

````markdown
# Qwen-Image-Edit-2511 (`aigd.image-qwen-image-edit-2511`)

Qwen 팀(Alibaba)의 **Qwen-Image-Edit-2511**은 이미지 **편집** 모델입니다. 이미지 1~4장과 지시문을 주면 간판의 글자를 바꾸거나, 색상이나 재질을 다르게 하거나, 사물을 추가·제거하거나, 이미지를 합성합니다. 이 패키지는 이 모델을 최고 품질(20 스텝)로 실행합니다. AI Game Dev에서는 **Local image generation**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 사용자의 NVIDIA GPU에서 로컬로 실행되며, 파일을 한 번 내려받으면 무료로 오프라인에서 동작합니다. Apache-2.0 라이선스이므로 상업적 사용이 허용됩니다. **NVIDIA GPU 16 GB 이상과 시스템 메모리(RAM) 32 GB**가 필요합니다.

편집 전용이며, 새 이미지를 만들 때의 기본 모델로는 절대 사용되지 않습니다.

## 무엇을 만들 수 있나요

- 기존 아트의 변형: 캐릭터 의상 색을 바꾸거나, 무기의 재질을 교체하거나, 장면의 계절이나 시간대를 바꿉니다.
- 기존 이미지 속 간판, 포스터, 라벨의 텍스트를 새로 넣거나 바로잡습니다.
- 사물 추가·제거: 탁자 위에 랜턴을 올리거나, 거리에서 군중을 지웁니다.
- 이미지 합성: 그림 2의 캐릭터를 그림 1의 장면에 넣습니다.
- 편집을 거쳐도 캐릭터가 일관되게 유지됩니다. 모델 카드에 따르면 2511 릴리스는 인물의 정체성을 더 잘 유지하고 단체 사진의 일관성도 개선했습니다.

## 요청 예시

- "이 그림에 있는 기사의 갑옷을 강철에서 금으로 바꿔 줘."
- "가게 간판의 글자를 'BLACKSMITH'로 바꿔 줘."
- "이 거리 배경에서 사람들을 지워 줘."
- "그림 2의 고양이를 그림 1의 창턱에 올려 줘."
- "이 낮 마을 장면을 창문에 불이 켜진 밤처럼 만들어 줘."

## 편집은 어떻게 동작하나요

에이전트는 모델에 참조 이미지 1~4장(`refImages`, 순서대로 "Picture 1..N")과 지시문을 전달합니다. 모델이 참조 이미지를 볼 수 있게 해 주는 것이 바로 비전 인코더(`mmproj-…`)입니다. 이것이 없으면 모든 편집이 프롬프트만으로 만든 새 이미지가 되어 버리므로, 앱은 비전 인코더가 없는 편집 모델을 거부합니다.

## 주요 특징

|  |  |
|---|---|
| 모델 | Qwen-Image-Edit-2511 (2025년 12월), GGUF Q4_K_M |
| 동작 | 편집 (참조 이미지 1~4장과 지시문) |
| 기본 크기 | 1024×1024 (최대 2048×2048) |
| 설정 | 20 스텝, guidance 2.5, Euler 샘플러, flow shift 3 |
| 텍스트 및 비전 인코더 | Qwen2.5-VL-7B-Instruct |
| 상업적 사용 | 허용 (Apache-2.0) |

## 최고 품질 또는 Lightning

[Qwen-Image-Edit-2511 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511-lightning)은 4 스텝 LoRA를 적용한 같은 모델로, 참조 이미지 1장 기준 편집 한 번에 약 20초가 걸려 약 2분인 원본보다 대략 5배 빠릅니다. 결과가 가장 중요할 때는 이 20 스텝 정식 모델을, 빠른 편집과 여러 지시문 시험에는 Lightning을 선택하세요. 두 모델은 기본 파일을 공유하므로, 둘 다 보유해도 추가 비용은 0.85 GB LoRA 하나뿐입니다.

편집이 아니라 새 이미지를 만들려면 [Qwen-Image-2512](https://ai-game.dev/packages/aigd.image-qwen-image-2512)와 [Qwen-Image-2512 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-2512-lightning)을 참고하세요.

## 지원 컴퓨터

| 컴퓨터 | 속도 |
|---|---|
| NVIDIA GPU 16 GB 이상 **그리고** RAM 32 GB (CUDA) | 참조 이미지 1장 기준 편집 한 번에 약 2분, 2장이면 약 3분 (1024²; 측정값 107초 / 186초) |

RTX 4090, RAM 64 GB 환경에서 측정한 값으로, 보장이 아닌 추정치입니다. Vulkan(AMD, Intel, Linux)에서는 아직 테스트되지 않아 해당 환경에서는 제공되지 않습니다.

## 다운로드

이 패키지는 데이터만 담고 있습니다. 모델 파일을 지정하며, 앱이 사용자의 확인 후 파일을 내려받아 각 파일을 sha256으로 검증하고 stable-diffusion.cpp로 사용자의 컴퓨터에서 실행합니다.

19.13 GB, 파일 4개이며 각각 Hugging Face 커밋에 고정되어 있습니다. Qwen-Image 모델들은 텍스트 인코더와 오토인코더를 공유하고( Lightning 모델들은 기본 모델을 공유하므로), 다른 모델을 내려받으며 이미 보유한 파일은 한 번만 저장되고 다시 내려받지 않습니다.

| 파일 | 출처 | 크기 |
|---|---|---:|
| `qwen-image-edit-2511-Q4_K_M.gguf` (디퓨전 모델) | [`unsloth/Qwen-Image-Edit-2511-GGUF`](https://huggingface.co/unsloth/Qwen-Image-Edit-2511-GGUF) | 12.84 GB |
| `qwen_image_vae.safetensors` (오토인코더) | [`Comfy-Org/Qwen-Image`](https://huggingface.co/Comfy-Org/Qwen-Image) | 0.25 GB |
| `Qwen2.5-VL-7B-Instruct-Q4_K_M.gguf` (텍스트 인코더) | [`ggml-org/Qwen2.5-VL-7B-Instruct-GGUF`](https://huggingface.co/ggml-org/Qwen2.5-VL-7B-Instruct-GGUF) | 4.68 GB |
| `mmproj-Qwen2.5-VL-7B-Instruct-f16.gguf` (비전 인코더) | [`ggml-org/Qwen2.5-VL-7B-Instruct-GGUF`](https://huggingface.co/ggml-org/Qwen2.5-VL-7B-Instruct-GGUF) | 1.35 GB |

## 라이선스

Apache-2.0. 상업적 사용이 허용됩니다.

- Qwen-Image-Edit-2511 © Qwen team (Alibaba) — [모델 카드](https://huggingface.co/Qwen/Qwen-Image-Edit-2511), Apache-2.0; GGUF 제공 [`unsloth/Qwen-Image-Edit-2511-GGUF`](https://huggingface.co/unsloth/Qwen-Image-Edit-2511-GGUF), Apache-2.0.
- 텍스트 및 비전 인코더 Qwen2.5-VL-7B-Instruct © Qwen team — [모델 카드](https://huggingface.co/Qwen/Qwen2.5-VL-7B-Instruct), Apache-2.0; GGUF 및 비전 프로젝터 제공 [`ggml-org/Qwen2.5-VL-7B-Instruct-GGUF`](https://huggingface.co/ggml-org/Qwen2.5-VL-7B-Instruct-GGUF), Apache-2.0.
- Qwen-Image 오토인코더 © Qwen team — 제공 [`Comfy-Org/Qwen-Image`](https://huggingface.co/Comfy-Org/Qwen-Image), Apache-2.0.

모든 파일은 Hugging Face에서 내려받습니다. AI Game Dev는 파일을 직접 호스팅하지 않습니다.
````
