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

> 스프라이트, 아이콘, 오브젝트를 실제 투명 배경(RGBA PNG)으로 8 스텝 만에 만듭니다. 비상업 라이선스이며, 다운로드 전에 동의해야 합니다. NVIDIA GPU 8 GB 이상이 필요하고, GPU가 없는 Windows PC에서는 프로세서로도 실행할 수 있습니다(느리며, 빠른 데스크톱에서 512 px 이미지 한 장에 약 1분). RAM은 16 GB입니다.

- Id: `aigd.image-qwen-image-2-1-turbo`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 이미지 모델
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.1.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

## 설치

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

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

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

## 버전

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

## 설명

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

**Qwen-Image-2.1 Turbo**는 Qwen 팀(Hangzhou Tongyi Laboratory)이 만든 모델로, **진짜 투명 배경**을 가진 이미지를 만듭니다. 스프라이트, 아이콘, 오브젝트를 RGBA PNG로 만들며 부드러운 가장자리와 반투명한 유리, 연기, 불까지 표현합니다. 일반적인 불투명 이미지도 만들 수 있습니다. Qwen-Image-2.1의 8스텝 **Turbo** 체크포인트이며, 이 모델의 오토인코더가 알파 채널을 디코딩합니다. AI Game Dev에서는 **Local image generation**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 8 GB 이상의 NVIDIA GPU에서 로컬로 실행되며, 사용 가능한 GPU가 없는 Windows PC에서는 프로세서에서 느리게 실행됩니다. 배경을 직접 지우지 않고도 잘라낸 게임 에셋이 필요한 게임 개발자에게 적합합니다. 단, 비상업적 라이선스입니다.

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

## 만들 수 있는 것

- 투명 배경의 캐릭터 및 오브젝트 스프라이트로, 장면에 바로 넣을 수 있습니다.
- 아이템, 능력, UI 아이콘을 RGBA PNG로 만듭니다.
- 부드럽거나 반투명한 가장자리를 가진 효과 요소: 유리, 연기, 불.
- 텍스트가 들어간 그림을 포함한 일반적인 불투명 이미지.

## 요청 예시

- "투명 배경에 나무 통 스프라이트를 만들어 줘."
- "루비, 에메랄드, 사파이어, 자수정 — 네 개의 보석 아이콘 세트를 투명 배경으로."
- "주문 효과용으로 투명 배경에 피어오르는 회색 연기."
- "초록빛으로 빛나는 액체가 담긴 유리 물약병, 투명 배경."

## 주요 특징

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

## 투명 배경

Asset Studio에서 이 모델을 선택하고 **Background → Transparent**를 켜세요. 앱은 모델 자체의 문구("이것은 투명도를 가진 RGBA 이미지입니다. … 이 이미지는 알파 채널이 있고 배경은 투명합니다.")로 설명을 감싸고, PNG로 저장한 뒤 실제로 투명 픽셀이 있는지 확인합니다. 투명 픽셀이 없는 결과에는 "투명도 없음"이라고 표시됩니다.

배경은 정확히 0이 아니라 알파 0–2(255 기준)로 나오고, 색상 채널에는 남은 색이 들어 있습니다. 가져올 때는 스트레이트 알파를 사용하거나 미리 곱하기(premultiply)를 적용하세요.

## 어떤 크기를 선택할까요

같은 모델이 세 가지 크기로 제공됩니다. 모두 같은 종류의 이미지를 만들며, 오토인코더와 텍스트 인코더를 공유하므로 두 번째 크기를 받을 때는 확산 모델만 다운로드합니다.

| 패키지 | 빌드 | 컴퓨터 | 다운로드 |
|---|---|---|---:|
| [Qwen-Image-2.1 Turbo Q3](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q3) | Q3_K_M | 6~8 GB의 NVIDIA GPU, 16 GB의 RAM | 8.87 GB |
| **Qwen-Image-2.1 Turbo**(이 패키지) | Q4_K_M | 8 GB 이상의 NVIDIA GPU, 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 | 12 GB 이상의 NVIDIA GPU, 24 GB의 RAM | 13.34 GB |

이 패키지는 세 가지 중 프로세서에서 제공되는 유일한 패키지입니다.

## 지원 컴퓨터

| 컴퓨터 | 속도 |
|---|---|
| 8 GB 이상의 NVIDIA GPU **및** 16 GB의 RAM(CUDA) | 1024² 이미지당 약 14.5초 |
| 사용 가능한 GPU가 없는 Windows PC, 16 GB의 RAM(프로세서, `win-x64-cpu` 빌드) | Ryzen 9 9950X에서 512² 이미지당 약 57초, 노트북에서는 몇 분 소요 |

64 GB의 RAM을 갖춘 RTX 4090에서 stable-diffusion.cpp `master-1106-532d2c1`로 측정한 결과: 최대 약 6.1 GB의 그래픽 메모리와 10 GB의 RAM을 사용하며(가중치는 RAM에 상주하다가 필요할 때 GPU로 이동), 로딩에 5–9초가 걸립니다. 프로세서에서는 약 9.4 GB의 RAM을 사용하고 기본적으로 512² 이미지를 만들며(최대 1024², 같은 데스크톱에서 약 5분). 어디까지나 추정치이며 보장치는 아닙니다. Vulkan(AMD, Intel, Linux)이나 Metal에서는 테스트되지 않아 아직 해당 환경에서는 제공되지 않습니다.

40스텝 기본 모델(이미지당 약 40초, 투명도 동일)과 커뮤니티의 4스텝 Lightning LoRA(라이선스 미표기) 대신 이 모델을 선택했습니다. 프로세서에서는 Q4_K_M 빌드가 Q3_K_M보다 빨랐습니다(512²에서 57초 대 62초).

## 다운로드

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

9.90 GB, 파일 세 개, 각각 Hugging Face 커밋에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `qwen-image-2.1-turbo-Q4_K_M.gguf`(확산 모델) | [`unsloth/Qwen-Image-2.1-Turbo-GGUF`](https://huggingface.co/unsloth/Qwen-Image-2.1-Turbo-GGUF) | 4.20 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 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 team(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 team — [`Comfy-Org/Qwen-Image-2.1`](https://huggingface.co/Comfy-Org/Qwen-Image-2.1)에서, Qwen Research License.
- 텍스트 인코더 Qwen3-VL-8B-Instruct © Qwen team — [`Qwen/Qwen3-VL-8B-Instruct-GGUF`](https://huggingface.co/Qwen/Qwen3-VL-8B-Instruct-GGUF), Apache-2.0.

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