# Qwen-Image-2.1 Turbo Q3（图像模型）

> Qwen-Image-2.1 Turbo 的较小版本（Q3\_K\_M），适用于 6 到 8 GB 的 NVIDIA GPU：8 步生成真正的透明背景（RGBA PNG）；文本编码器在处理器上运行。非商业许可：下载前需先接受。需要 16 GB 内存。

- 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/zh-hans/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 团队（杭州通义实验室）打造的 **Qwen-Image-2.1 Turbo** 的 3 位（Q3_K_M）版本，面向 6 到 8 GB 的显卡：8 步即可生成带**真正透明背景**的图像（精灵图、图标、玻璃、烟雾、火焰，输出为 RGBA PNG）以及普通图像。它的文本编码器在处理器上运行（`--backend te=cpu`），每张图会因此多花一两秒，却能为显卡腾出约 2 GB 显存；效果看起来与 4 位版本差不多。在 AI Game Dev 中，它通过**本地图像生成**在你的 NVIDIA GPU 上本地运行（[`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp)）。它适合使用中端显卡、需要抠图游戏素材的游戏开发者——采用非商业许可。

> **非商业许可。** 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 Q3_K_M |
| 操作 | 文本生成图像 |
| 输出 | 带真正透明背景的 RGBA PNG，或普通图像 |
| 默认尺寸 | 1024×1024（最高 2048×2048） |
| 设置 | 8 步，guidance 1，Euler 采样器，配合模型自带的 8 步调度 |
| 文本编码器 | Qwen3-VL-8B-Instruct，默认在处理器上运行 |
| 许可 | Qwen Research License：仅限非商业使用 |

## 透明背景

在 Asset Studio 中选择此模型，并开启**背景 → 透明**。应用会用模型自带的短语包装你的描述，保存为 PNG，并检查它确实含有透明像素。背景的 alpha 值为 0–2（满值 255），而非精确的 0：导入时请使用直通 alpha，或进行预乘处理。

## 该选哪个版本

| 包 | 量化版本 | 电脑 | 下载 |
|---|---|---|---:|
| **Qwen-Image-2.1 Turbo Q3**（本包） | Q3_K_M | NVIDIA GPU，6 到 8 GB 显存，16 GB 内存 | 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 内存；或 Windows 电脑的处理器 | 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 内存 | 13.34 GB |

如果你的显卡有 6 到 8 GB 显存，就选这个版本。显存 8 GB 及以上时，4 位版本是标准选择；12 GB 及以上时，8 位版本的细节会稍微更精细。

## 适用电脑

| 电脑 | 速度（一张 1024² 图像） |
|---|---|
| NVIDIA GPU 6 GB 及以上**并且** 16 GB 内存（CUDA） | 约 14–15 秒 |

使用 stable-diffusion.cpp `master-1106-532d2c1` 在配备 64 GB 内存的 RTX 4090 上测得：峰值约为 4.5–5 GB 显存和 9.2 GB 内存。尚未在 6 GB 显卡上实测：这只是估算，不是保证。**模型 → 文本编码器**可以把文本编码器移回 GPU（或对所有模型都移到 CPU）。

## 下载

本包只是数据：它指明模型文件。在你接受许可并确认后，应用会从 Hugging Face 下载这些文件，逐个用 sha256 校验，并在你的电脑上用 stable-diffusion.cpp 运行它们。

8.87 GB，三个文件，每个都固定到某个 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 团队（杭州通义实验室）——[模型卡](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 不托管它们。
````
