# Z-Image Turbo (이미지 모델)

> Z-Image Turbo를 로컬에서 실행하세요: 8단계 만에 읽기 쉬운 짧은 텍스트가 들어간 사실적·일러스트풍 이미지, 아이콘, 텍스처를 빠르게 만듭니다. 가장 작은 PC 모델로, 4 GB 이상 NVIDIA GPU와 8 GB 이상 다른 GPU에서 실행되며 통합 GPU에서도 느리게 동작합니다. Apache-2.0, 상업적 사용 허용.

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

## 설치

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

```bash
gamedev pkg add aigd.image-z-image-turbo
```

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

## 버전

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

## 설명

````markdown
# Z-Image Turbo 이미지 모델 (`aigd.image-z-image-turbo`)

**Z-Image-Turbo**는 Tongyi-MAI(Alibaba)가 만든 빠른 증류 60억 매개변수 이미지 모델로, **8단계** 만에 읽기 쉬운 짧은 텍스트가 포함된 사실적·일러스트풍 이미지를 생성합니다. AI Game Dev에서는 **Local image generation**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 로컬에서 실행되며, 파일을 다운로드한 뒤에는 무료로 오프라인에서 동작합니다. 카탈로그에서 가장 작은 PC 모델이자 AMD, Intel 및 통합 GPU에서도 실행되는 유일한 모델이라 대부분의 컴퓨터에 적합합니다. NVIDIA 카드는 4 GB부터, 다른 GPU는 8 GB부터, 그리고 통합 GPU만 있는 컴퓨터에서도 (느리게) 실행됩니다. Apache-2.0 라이선스로 상업적 사용이 허용됩니다.

## 무엇을 만들 수 있나요

- 캐릭터, 소품, 환경의 사실적·일러스트풍 컨셉 아트.
- 아이템, 능력, UI용 아이콘.
- 표면과 재질용 텍스처 이미지.
- 짧고 읽기 쉬운 텍스트가 들어간 이미지: 표지판의 단어, 라벨, 제목 초안. 모델 카드에는 중국어와 영어 텍스트가 명시되어 있습니다.
- 기존 그림의 변형(이미지 투 이미지).

## 요청 예시

- "금색 테두리가 있는 나무 보물 상자 아이콘을 단순한 배경으로 만들어 주세요."
- "이끼 낀 조약돌 텍스처, 위에서 내려다본 시점, 균일한 조명."
- "'The Golden Goose'라고 적힌 판타지 스타일의 선술집 간판."
- "오픈 월드 지도용으로 새벽의 눈 덮인 산속 마을을 사진 스타일 컨셉으로."

## 주요 특징

|  |  |
|---|---|
| 모델 | Z-Image-Turbo (6B, 증류), GGUF Q3_K |
| 지원 작업 | 텍스트 투 이미지, 이미지 투 이미지 |
| 기본 크기 | 1024×1024 (최대 2048×2048); 통합 GPU에서는 512×512 (최대 1024×1024) |
| 설정 | 8단계, guidance 1 |
| 텍스트 인코더 | Qwen3-4B-Instruct-2507 |
| GPU | NVIDIA (CUDA), AMD / Intel / 구형 NVIDIA 및 통합 GPU (Vulkan) |
| 상업적 사용 | 허용 (Apache-2.0) |

## 어떤 컴퓨터에서 실행되나요

| 컴퓨터 | 속도 (이미지 1장, 512² / 1024²) |
|---|---|
| 8 GB 이상 NVIDIA GPU (CUDA) | 약 1초 / 5초 |
| 4–8 GB NVIDIA GPU (CUDA) | 약 1.5초 / 6초 |
| 8 GB 이상 AMD, Intel 또는 구형 NVIDIA GPU (Vulkan) | 약 2초 / 14초 |
| 통합 GPU만 있는 경우 (Vulkan) | **매우 느림**: 512² 이미지 한 장에 약 6분; 기본 512², 최대 1024² |

시간은 보장이 아닌 추정치이며 RTX 4090에서 측정했습니다: CUDA 및 메모리 제한 없음(첫 번째 행), CUDA를 GPU 메모리 4 GB로 제한(두 번째 행), Vulkan 경유(세 번째 행). 마지막 행은 AMD Radeon 통합 GPU에서 측정했습니다. 더 작은 카드는 더 느립니다.

다운로드한 여러 모델이 컴퓨터에 맞으면 앱은 가장 좋은 것을 사용합니다: 8 GB 이상 NVIDIA GPU에서는 [FLUX.1 schnell](https://ai-game.dev/packages/aigd.image-flux1-schnell), 16 GB 이상 NVIDIA GPU와 32 GB RAM이 있으면 [Qwen-Image](https://ai-game.dev/packages/aigd.image-qwen-image) — 모두 다운로드한 경우에 해당합니다.

## 다운로드

이 패키지는 데이터만 포함합니다. 모델 파일 이름을 지정하면, 앱이 확인을 받은 뒤 다운로드하고 각 파일을 sha256으로 검증한 다음 stable-diffusion.cpp로 컴퓨터에서 실행합니다.

5.98 GB, 파일 3개, 각각 Hugging Face 커밋에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `z_image_turbo-Q3_K.gguf` (디퓨전 모델) | [`leejet/Z-Image-Turbo-GGUF`](https://huggingface.co/leejet/Z-Image-Turbo-GGUF) | 3.14 GB |
| `Qwen3-4B-Instruct-2507-Q4_K_M.gguf` (텍스트 인코더) | [`unsloth/Qwen3-4B-Instruct-2507-GGUF`](https://huggingface.co/unsloth/Qwen3-4B-Instruct-2507-GGUF) | 2.50 GB |
| `ae.safetensors` (오토인코더) | [`Comfy-Org/Z-Image-Turbo`](https://huggingface.co/Comfy-Org/Z-Image-Turbo) | 0.34 GB |

FLUX.1 schnell은 동일한 `ae.safetensors`을 사용합니다. 앱은 이를 한 번만 저장합니다.

## 라이선스

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

- Z-Image-Turbo © Tongyi-MAI (Alibaba) — [모델 카드](https://huggingface.co/Tongyi-MAI/Z-Image-Turbo), Apache-2.0; GGUF는 [`leejet/Z-Image-Turbo-GGUF`](https://huggingface.co/leejet/Z-Image-Turbo-GGUF) 제공, Apache-2.0.
- 텍스트 인코더 Qwen3-4B-Instruct-2507 © Qwen team — [모델 카드](https://huggingface.co/Qwen/Qwen3-4B-Instruct-2507), Apache-2.0; GGUF는 [`unsloth/Qwen3-4B-Instruct-2507-GGUF`](https://huggingface.co/unsloth/Qwen3-4B-Instruct-2507-GGUF) 제공, Apache-2.0.
- FLUX.1 오토인코더 © Black Forest Labs — [`Comfy-Org/Z-Image-Turbo`](https://huggingface.co/Comfy-Org/Z-Image-Turbo) 제공, Apache-2.0.

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