# Qwen-Image-2.1 Turbo Q3 (이미지 모델)

> Qwen-Image-2.1 Turbo의 더 작은 빌드(Q3\_K\_M)로, 6~8 GB의 NVIDIA GPU용입니다. 8스텝으로 진짜 투명 배경(RGBA PNG)을 만들며, 텍스트 인코더는 프로세서에서 실행됩니다. 비상업적 라이선스로, 다운로드 전에 동의해야 합니다. 16 GB의 RAM이 필요합니다.

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

## 설치

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

```bash
gamedev pkg add aigd.image-qwen-image-2-1-turbo-q3
```

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

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0` | 최신 |
| 1.0.1 | 2026-11-21 | `>=0.32.0` | - |

## 설명

````markdown
# Qwen-Image-2.1 Turbo Q3 (`aigd.image-qwen-image-2-1-turbo-q3`)

Qwen 팀(Hangzhou Tongyi Laboratory)이 6~8 GB 그래픽 카드를 위해 만든 **Qwen-Image-2.1 Turbo**의 3비트(Q3_K_M) 빌드입니다. 8스텝으로 **진짜 투명 배경** 이미지(스프라이트, 아이콘, 유리, 연기, 불을 RGBA PNG로)와 일반 이미지를 만듭니다. 텍스트 인코더가 프로세서(`--backend te=cpu`)에서 실행되어 이미지 한 장당 1~2초 정도로 약 2 GB의 그래픽 메모리를 확보하며, 4비트 빌드와 거의 비슷해 보였습니다. AI Game Dev에서는 **Local image generation**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 여러분의 NVIDIA GPU에서 로컬로 실행됩니다. 잘라낸 게임 에셋이 필요한 중급 그래픽 카드 사용 게임 개발자에게 적합합니다. 단, 비상업적 라이선스입니다.

> **비상업적 라이선스.** Qwen-Image-2.1은 Qwen RESEARCH LICENSE AGREEMENT를 따릅니다. 연구 또는 평가 용도로만 사용할 수 있습니다. 상업적 사용에는 Qwen(model-business@notice.qwencloud.com)의 별도 라이선스가 필요합니다. 앱은 모델을 다운로드하기 전에 라이선스 동의를 요청하며, 사용 방식에 대한 책임은 사용자에게 있습니다. Asset Studio는 컴퓨터에서 이 모델이 잘 실행되면 이를 먼저 표시하고, 다운로드 전에 라이선스 동의를 요청합니다(또는 다른 모델을 선택하도록 안내합니다). 에이전트는 투명 배경이 있는 그림에만 이 모델을 제안하며, 에이전트의 기본값이 되지 않고 클라우드 또는 유료 생성에도 절대 사용되지 않습니다.

## 만들 수 있는 것

- 투명 배경의 캐릭터 및 오브젝트 스프라이트.
- RGBA PNG 형식의 아이템, 능력, UI 아이콘.
- 부드럽거나 반투명한 가장자리가 있는 효과 요소: 유리, 연기, 불.
- 일반적인 불투명 이미지.

## 요청 예시

- "투명 배경에 보물 상자 스프라이트를 만들어 주세요."
- "투명 배경의 코인과 보석 픽업 아이콘 다섯 개를 만들어 주세요."
- "폭발 효과를 위한 투명 배경의 주황색 화염 폭발을 만들어 주세요."

## 주요 특징

|  |  |
|---|---|
| 모델 | Qwen-Image-2.1 Turbo, GGUF Q3_K_M |
| 작업 | 텍스트 → 이미지 |
| 출력 | 진짜 투명 배경의 RGBA PNG 또는 일반 이미지 |
| 기본 크기 | 1024×1024 (최대 2048×2048) |
| 설정 | 8스텝, guidance 1, 모델 자체의 8스텝 스케줄을 쓰는 Euler 샘플러 |
| 텍스트 인코더 | Qwen3-VL-8B-Instruct, 기본적으로 프로세서에서 실행 |
| 라이선스 | Qwen Research License: 비상업적 사용만 가능 |

## 투명 배경

Asset Studio에서 이 모델을 선택하고 **Background → Transparent**를 켜세요. 앱이 설명을 모델 자체의 문구로 감싸고, PNG로 저장한 뒤 실제로 투명 픽셀이 있는지 확인합니다. 배경은 정확히 0이 아니라 알파 0–2(255 기준)로 나오므로, 가져올 때 straight alpha를 쓰거나 미리 곱하세요(premultiply).

## 어떤 빌드를 고를까요

| 패키지 | 빌드 | 컴퓨터 | 다운로드 |
|---|---|---|---:|
| **Qwen-Image-2.1 Turbo Q3**(이 패키지) | Q3_K_M | NVIDIA GPU 6~8 GB, 16 GB RAM | 8.87 GB |
| [Qwen-Image-2.1 Turbo](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo) | Q4_K_M | NVIDIA GPU 8 GB 이상, 16 GB RAM; 또는 Windows PC의 프로세서 | 9.90 GB |
| [Qwen-Image-2.1 Turbo Q8](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q8) | Q8_0 | NVIDIA GPU 12 GB 이상, 24 GB RAM | 13.34 GB |

그래픽 메모리가 6~8 GB인 카드라면 이 빌드를 선택하세요. 8 GB 이상이면 4비트 빌드가 표준 선택이고, 12 GB 이상이면 8비트 빌드가 디테일을 조금 더 세밀하게 표현합니다.

## 실행 가능한 컴퓨터

| 컴퓨터 | 속도(1024² 이미지 한 장) |
|---|---|
| NVIDIA GPU 6 GB 이상 **및** 16 GB RAM (CUDA) | 약 14–15초 |

RTX 4090, 64 GB RAM 환경에서 stable-diffusion.cpp `master-1106-532d2c1`로 측정: 최대 약 4.5–5 GB의 그래픽 메모리와 9.2 GB의 RAM을 사용했습니다. 6 GB 카드에서는 아직 측정하지 않았으므로 추정치이며 보장은 아닙니다. **Models → Text encoder**에서 텍스트 인코더를 다시 GPU로(또는 모든 모델에 대해 CPU로) 옮길 수 있습니다.

## 다운로드

이 패키지는 데이터만 담고 있으며 모델 파일을 지정합니다. 라이선스에 동의하고 확인하면 앱이 Hugging Face에서 파일을 다운로드하고 각 파일을 sha256으로 검증한 뒤, 여러분의 컴퓨터에서 stable-diffusion.cpp로 실행합니다.

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

| 파일 | 출처 | 크기 |
|---|---|---:|
| `qwen-image-2.1-turbo-Q3_K_M.gguf` (디퓨전 모델) | [`unsloth/Qwen-Image-2.1-Turbo-GGUF`](https://huggingface.co/unsloth/Qwen-Image-2.1-Turbo-GGUF) | 3.17 GB |
| `qwen_image_2.1_vae_bf16.safetensors` (RGBA 오토인코더) | [`Comfy-Org/Qwen-Image-2.1`](https://huggingface.co/Comfy-Org/Qwen-Image-2.1) | 0.68 GB |
| `Qwen3VL-8B-Instruct-Q4_K_M.gguf` (텍스트 인코더) | [`Qwen/Qwen3-VL-8B-Instruct-GGUF`](https://huggingface.co/Qwen/Qwen3-VL-8B-Instruct-GGUF) | 5.03 GB |

오토인코더와 텍스트 인코더는 다른 Qwen-Image-2.1 Turbo 패키지와 동일한 파일이므로, 이미 이 파일들을 가지고 있는 컴퓨터는 디퓨전 모델만 다운로드합니다.

## 라이선스

**Qwen RESEARCH LICENSE AGREEMENT**([전문](https://huggingface.co/Qwen/Qwen-Image-2.1-Turbo/blob/fc13ba1986fcb905854dc8de2f52eee395f49b5b/LICENSE)). 비상업적 사용만 무료입니다("for research or evaluation purposes only"). 상업적 사용은 Qwen의 별도 라이선스로 가능하며, model-business@notice.qwencloud.com으로 요청하세요.

모델을 공유할 때 Qwen 라이선스 고지를 유지하고, 이 모델의 이미지로 배포하는 AI 모델을 학습시켰다면 "Built with Qwen"라고 명시하세요.

Qwen is licensed under the Qwen RESEARCH LICENSE AGREEMENT, Copyright (c) 2026 Hangzhou Tongyi Laboratory Technology Co., Ltd. All Rights Reserved.

- Qwen-Image-2.1-Turbo © Qwen 팀(Hangzhou Tongyi Laboratory) — [모델 카드](https://huggingface.co/Qwen/Qwen-Image-2.1-Turbo), Qwen Research License; GGUF는 [`unsloth/Qwen-Image-2.1-Turbo-GGUF`](https://huggingface.co/unsloth/Qwen-Image-2.1-Turbo-GGUF) 제공, Qwen Research License.
- Qwen-Image-2.1 오토인코더 © Qwen 팀 — [`Comfy-Org/Qwen-Image-2.1`](https://huggingface.co/Comfy-Org/Qwen-Image-2.1) 제공, Qwen Research License.
- 텍스트 인코더 Qwen3-VL-8B-Instruct © Qwen 팀 — [`Qwen/Qwen3-VL-8B-Instruct-GGUF`](https://huggingface.co/Qwen/Qwen3-VL-8B-Instruct-GGUF), Apache-2.0.

모든 파일은 Hugging Face에서 다운로드합니다. AI Game Dev는 파일을 호스팅하지 않습니다.
````
