# Qwen-Image (이미지 모델)

> Qwen-Image를 로컬에서 실행합니다. 간판, 포스터, UI 목업, 일러스트, 사진에서 카탈로그 내 최고의 텍스트 렌더링과 프롬프트 준수력을 보여줍니다. 텍스트 투 이미지와 이미지 투 이미지를 지원합니다. Apache-2.0, 상업적 사용 가능. 16 GB 이상의 NVIDIA GPU와 32 GB의 RAM이 필요합니다.

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

## 설치

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

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

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

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.20.0` | 최신 |
| 1.0.3 | 2026-11-18 | `>=0.20.0` | - |
| 1.0.2 | 2026-11-06 | `>=0.20.0` | - |
| 1.0.1 | 2026-10-13 | `>=0.20.0` | - |
| 1.0.0 | 2026-10-05 | `>=0.20.0` | - |

## 설명

````markdown
# Qwen-Image 이미지 모델 (`aigd.image-qwen-image`)

**Qwen-Image**는 Qwen team(Alibaba)이 만든 대형 이미지 모델로, 텍스트 렌더링으로 유명합니다. 간판, 포스터, UI 목업, 일러스트, 사진에서 카탈로그 내 최고의 텍스트 렌더링과 프롬프트 준수력을 자랑합니다. 이 패키지는 최초 릴리스(2025년 8월)입니다. AI Game Dev에서는 **Local image generation**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 사용자의 NVIDIA GPU에서 로컬로 실행되며, 파일을 한 번 내려받으면 무료로 오프라인에서 동작합니다. Apache-2.0 라이선스이므로 상업적 사용이 가능합니다. **16 GB 이상의 NVIDIA GPU와 32 GB의 시스템 메모리**(RAM)가 필요합니다. 모델 가중치는 RAM에 보관되고 필요할 때 GPU로 옮겨집니다.

## 무엇을 만들 수 있나요

- 읽을 수 있는 텍스트가 들어간 이미지: 상점 간판, 포스터, 배너, 책 표지, 게임 세계 속 라벨 등입니다. 모델 카드에는 영어와 중국어 텍스트가 언급되어 있으며, 중국어가 가장 뛰어납니다.
- UI 목업: 메뉴, HUD 레이아웃, 화면 콘셉트.
- 길고 자세한 프롬프트를 잘 따라가는 키 아트와 스토어 이미지.
- 사실적인 사진부터 회화풍, 애니메이션풍까지 다양한 스타일의 일러스트와 사진.
- 기존 그림의 변형(이미지 투 이미지).

## 요청 예시

- "나무 벽에 붙은 현상 수배 포스터, 'WANTED: BLACK JACK — 500 GOLD'라고 적혀 있고, 서부극 스타일."
- "판타지 RPG 메인 메뉴 목업, 버튼은 New Game, Continue, Options, Quit."
- "국수집 위의 네온 사인에 'NIGHT NOODLES', 비 내리는 거리, 밤."
- "우리 우주 게임의 키 아트: 거대한 고리가 있는 행성 앞에 홀로 선 조종사, 상단에 타이틀 공간."

## 주요 특징

|  |  |
|---|---|
| 모델 | Qwen-Image (2025년 8월), GGUF Q4_K_M |
| 지원 작업 | 텍스트 투 이미지, 이미지 투 이미지 |
| 기본 크기 | 1024×1024 (최대 2048×2048) |
| 설정 | 20스텝, guidance 2.5, Euler 샘플러, flow shift 3 |
| 텍스트 인코더 | Qwen2.5-VL-7B-Instruct |
| 상업적 사용 | 가능 (Apache-2.0) |

## 다른 Qwen-Image 모델

- [Qwen-Image-2512](https://ai-game.dev/packages/aigd.image-qwen-image-2512) — 이 모델의 2025년 12월 업데이트, 동일한 하드웨어, 20스텝.
- [Qwen-Image-2512 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-2512-lightning) — Qwen-Image-2512를 4스텝으로, 약 4배 빠릅니다.
- [Qwen-Image-Edit-2511](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511) 및 [Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511-lightning) 변형 — 지시에 따라 기존 이미지를 편집합니다.
- [Qwen-Image-2.1 Turbo](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo) — 더 작은 GPU에서 실제 투명 배경이 있는 이미지(비상업적 라이선스).

Qwen-Image, Qwen-Image-2512, 편집 모델은 동일한 텍스트 인코더와 오토인코더를 사용합니다. 다른 모델을 내려받아 이미 가지고 있는 파일은 한 번만 저장되며 다시 내려받지 않습니다.

## 어떤 컴퓨터에서 쓸 수 있나요

| 컴퓨터 | 속도 (이미지 한 장, 512² / 1024²) |
|---|---|
| 16 GB 이상의 NVIDIA GPU **및** 32 GB의 RAM (CUDA) | 약 9초 / 32초 |

RTX 4090, 64 GB RAM 환경에서 측정했으며 서버는 약 17 GB의 RAM을 사용했습니다. 보장이 아닌 추정치입니다. Qwen-Image는 Vulkan(AMD, Intel, Linux)에서 테스트되지 않아 아직 해당 환경에서는 제공되지 않습니다.

## 다운로드

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

18.00 GB, 파일 3개, 각각 Hugging Face 커밋에 고정되어 있습니다:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `Qwen_Image-Q4_K_M.gguf` (디퓨전 모델) | [`QuantStack/Qwen-Image-GGUF`](https://huggingface.co/QuantStack/Qwen-Image-GGUF) | 13.07 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 |
| `qwen_image_vae.safetensors` (오토인코더) | [`Comfy-Org/Qwen-Image`](https://huggingface.co/Comfy-Org/Qwen-Image) | 0.25 GB |

## 라이선스

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

- Qwen-Image © Qwen team (Alibaba) — [모델 카드](https://huggingface.co/Qwen/Qwen-Image), Apache-2.0; GGUF는 [`QuantStack/Qwen-Image-GGUF`](https://huggingface.co/QuantStack/Qwen-Image-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는 파일을 직접 호스팅하지 않습니다.
````
