一、模型速览
| 项目 | 说明 |
|---|---|
| 发布方 | 阿里巴巴 Qwen 团队 |
| 发布时间 | 2025-09-30(开源权重上架 HF + ModelScope;2026 年仍是稳定可部署的 Apache-2.0 选择) |
| 架构 | Qwen3-ViT 视觉编码器(SigLIP-2 SO-400M 初始化 + 动态分辨率 2D-RoPE)+ 2 层 MLP 视觉语言融合器 + Qwen3 MoE 主干(48 层,GQA 32Q/4KV) |
| 参数 | 总参数 30.5B(约 31.1B),每 token 激活 3.3B;128 专家、每 token 路由 8 个 |
| 能力 | 图像/视频理解、文档 OCR、2D/3D grounding、视觉编码、GUI 智能体、长视频秒级定位 |
| 上下文 | 原生 256K(262,144 tokens),可扩展到 1M |
| 许可证 | Apache 2.0(可商用、可微调、可再分发) |
| 权重体积 | BF16 全量约 62GB;AWQ 4-bit 约 18GB;GGUF Q4_K_M 约 17--19GB;GGUF Q8_0 约 32.5GB |
一句话:它是把"30B 知识容量 + 3B 激活开销"塞进一个 Apache-2.0 检查点的"效率旗舰"------吃满 30B 的理解力,却只付出稠密 3B 级别的每 token 算力,是少见的"能商用 + 能上消费级显卡"的多模态大模型。
它与本专栏 9/24 写过的 Qwen-Image-2.1(仅 Qwen Research License 非商用)路线完全不同:Qwen3-VL-30B-A3B 是纯理解型视觉语言模型(出文、不吃图),而且从发布起就是 Apache 2.0------"能下载"就等于"能上线",没有 Qwen-Image-2.1 那道许可坎。
数据来源:Qwen/Qwen3-VL-30B-A3B-Instruct 模型卡 + Qwen3-VL Technical Report。关键提醒:同系列的 Qwen3-VL-235B-A22B(22B 激活)是旗舰稠密-MoE 变体,8B 是边缘稠密变体;本文聚焦 30B-A3B 这个"效率/能力平衡点"。Thinking 变体(同名 + -Thinking)带专用推理块、分数更高但更慢,下文对比表区分两者。
二、核心亮点:为什么 30B-A3B 值得本地跑
1. MoE 把"能力"和"开销"解耦。 30.5B 总参数意味着它装得下接近旗舰级别的多模态知识,但每 token 只点亮 3.3B(128 个专家里路由 8 个)。结果就是:在 24GB 显卡上量化后单卡可跑,单位 token 算力却远低于同能力的稠密模型。llmrun 实测数据:Q4_K_M 在 RTX 3090(24GB)上约有 4GB 余量、生成速度约 153 tok/s(社区数据,待复现)。这对"想上本地多模态、又不想买 80GB 卡"的团队是直接利好(来源:llmrun / open-llm-radar 拆解)。
2. 原生 256K + Interleaved-MRoPE,长视频/长文档是真长。 原生上下文 262,144 tokens,配合 YaRN 可扩到 1M;Interleaved-MRoPE 在时间/宽/高三个维度上做全频率交错的位置编码,专门强化长时序视频推理。官方说法是"小时级视频 + 秒级索引"------这对监控摘要、长课程/会议理解这类真实场景,比很多"标称长上下文但视频一拉长就糊"的模型更靠谱(来源:模型卡 / Technical Report)。
3. Text-Timestamp Alignment,视频能"指时间"。 这代放弃了上代的 T-RoPE,改用时间戳对齐的事件定位,能回答"第几秒发生了什么"这类精确到秒的问题,而不只是笼统描述。配合 DeepStack(多层 ViT 特征融合,抓细粒度细节 + 锐化图文对齐),视频时序问答是 30B-A3B 相对前代最实打实的升级(来源:模型卡)。
4. 视觉智能体 + 视觉编码,把"看图"变成"干活"。 它能在 PC/手机 GUI 上识别元素、理解功能、调用工具完成任务;能从图片/视频直接生成 Draw.io / HTML / CSS / JS;2D grounding 更强、并首次支持 3D grounding(空间推理、具身 AI)。OCR 扩到 32 种语言(前代 19),弱光/模糊/倾斜更稳。换言之,它不止"看得懂",还接得上 RPA、前端生成、文档自动化这些流水线(来源:Technical Report / cair-cas 昇腾适配文)。
5. 日零生态 + 真正的 Apache 2.0 商用自由。 transformers(>=4.57,或源码版)、vLLM(>=0.11.0)、SGLang、ms-swift(>=4.0)、llama.cpp / Ollama / LM Studio(GGUF)均在发布即支持,昇腾也 0Day 适配(LLaMA Factory + vLLM)。最重要的是许可证:Apache 2.0 允许商用、微调、再分发,没有 Qwen-Image-2.1 那种"能下载≠能上线"的坑------部署前不必先谈许可(来源:HF 模型卡 / 昇腾社区文)。
三、部署实战:三条可运行链路
环境准备(Transformers 路线,最通用,需新版 transformers)
bash
bash
# Qwen3-VL 需要较新的 transformers;4.57 已含 Qwen3VLMoeForConditionalGeneration
pip install "transformers>=4.57" "qwen_vl_utils>=0.0.14" "accelerate"
# 多图/视频场景强烈建议 flash-attn 提速省显存
pip install flash-attn --no-build-isolation
# 若官方未发布对应稳定版,可从源码装:
# pip install git+https://github.com/huggingface/transformers
推理代码(图文理解 + 多图/视频,复制即跑)
python
python
import torch
from transformers import Qwen3VLMoeForConditionalGeneration, AutoProcessor
from qwen_vl_utils import process_vision_info
# 1. 加载 BF16 权重(首次自动下载约 62GB),device_map="auto" 自动分卡/CPU 卸载
model = Qwen3VLMoeForConditionalGeneration.from_pretrained(
"Qwen/Qwen3-VL-30B-A3B-Instruct",
torch_dtype=torch.bfloat16,
attn_implementation="flash_attention_2", # 没装 flash-attn 删掉此行
device_map="auto",
)
processor = AutoProcessor.from_pretrained("Qwen/Qwen3-VL-30B-A3B-Instruct")
# 2. 单图理解
messages = [{
"role": "user",
"content": [
{"type": "image", "image": "https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-VL/assets/demo.jpeg"},
{"type": "text", "text": "详细描述这张图片中的物体、文字和场景。"},
],
}]
text = processor.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
image_inputs, video_inputs = process_vision_info(messages, image_patch_size=16)
# 3. 组装输入(qwen-vl-utils 已 resize,processor 不必再 resize)
inputs = processor(
text=[text], images=image_inputs, videos=video_inputs,
return_tensors="pt",
).to("cuda")
# 4. 生成:务必 trim 掉输入前缀,只解新生成部分
generated_ids = model.generate(**inputs, max_new_tokens=512)
generated_ids_trimmed = [out[len(inp):] for inp, out in zip(inputs.input_ids, generated_ids)]
print(processor.batch_decode(generated_ids_trimmed, skip_special_tokens=True)[0])
多图对比把 content 里放多个
{"type": "image", ...}即可;视频用{"type": "video", "video": "clip.mp4", "fps": 1.0}(fps 越低 token 越少、越省显存)。image_patch_size对 Qwen3-VL 必须为 16(Qwen2.5-VL 是 14)。
效果验证(计时 + 峰值显存自检,复制即跑)
python
python
import torch, time
# 接上面已加载的 model / processor
t0 = time.time()
generated_ids = model.generate(**inputs, max_new_tokens=256)
print(f"生成 256 token 耗时 {time.time()-t0:.1f}s | "
f"峰值显存 {torch.cuda.max_memory_allocated()/1e9:.1f}GB")
备选链路 A:vLLM 高吞吐服务(OpenAI 兼容,双卡 BF16)
bash
bash
pip install "vllm>=0.11.0"
# 双卡张量并行跑 BF16 全量;--tensor-parallel-size 按卡数调整
vllm serve Qwen/Qwen3-VL-30B-A3B-Instruct \
--tensor-parallel-size 2 \
--max-model-len 32768 \
--gpu-memory-utilization 0.9 \
--trust-remote-code
# 单卡 24GB 想跑全功能:换 AWQ 4-bit 权重(约 18GB)
# vllm serve QuantTrio/Qwen3-VL-30B-A3B-Instruct-AWQ \
# --tensor-parallel-size 1 --max-model-len 16384 \
# --gpu-memory-utilization 0.9 --trust-remote-code
bash
bash
# 调用(OpenAI 兼容):多模态走 messages 里的 image_url / 本地 base64
curl -X POST "http://localhost:8000/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-VL-30B-A3B-Instruct",
"messages": [{"role":"user","content":[
{"type":"image_url","image_url":{"url":"https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-VL/assets/demo.jpeg"}},
{"type":"text","text":"图里有什么?"}
]}]
}'
备选链路 B:GGUF 单卡消费级(Ollama / LM Studio / llama.cpp)
bash
bash
# Ollama 一键跑 Q4_K_M(约 18.6GB,含视觉投影器)
ollama run hf.co/DevQuasar/Qwen.Qwen3-VL-30B-A3B-Instruct-GGUF:Q4_K_M
# 量化档速查(权重文件体积,来源 DevQuasar / lmstudio-community):
# Q2_K ~11.3GB | Q3_K_M ~14.7GB | Q4_K_M ~17--18.6GB | Q6_K ~25.1GB | Q8_0 ~32.5GB
# 视觉投影器 mmproj-Qwen3-VL-30B-A3B-Instruct-F16.gguf(约 1GB)必须配套,否则吃不了图/视频
说明:以上来自 Qwen 官方 Quickstart、Qwen3-VL Best Practice(ms-swift 文档)、vLLM Qwen3-VL Guide 与 DevQuasar/lmstudio-community 的 GGUF 仓库。
device_map="auto"是 transformers 为显存受限机器提供的自动分卡/CPU 卸载选项;generate后务必out[len(inp):]裁掉输入前缀。多模态 GGUF 必须经 mmproj 投影器把图像编码成视觉 token,纯文本 GGUF 不含该路径,部署前确认仓库带mmproj-*.gguf。本机无 GPU,未做实测,请读者按自有硬件验证速度与显存。
四、性能测评:同级模型怎么选
| 模型 | 架构 | 激活参数 | 许可证 | 原生上下文 | 显存(BF16) | 量化可下探 | 能力定位 |
|---|---|---|---|---|---|---|---|
| Qwen3-VL-30B-A3B-Instruct | MoE 30.5B | 3.3B | Apache 2.0 | 256K→1M | ~62GB | Q4_K_M ~18.6GB(单 24GB 卡) | 效率旗舰,能力≈GPT-4.1-mini / Sonnet 4 |
| Qwen3-VL-8B-Instruct | 稠密 | 8B | Apache 2.0 | 256K→1M | ~16GB | Q4_K_M ~5GB | 边缘/嵌入式 |
| Qwen3-VL-235B-A22B-Instruct | MoE 235B | 22B | Apache 2.0 | 256K→1M | ~470GB | 需多卡 | 系列旗舰 |
| Qwen2.5-VL-72B | 稠密 | 72B | Apache 2.0 | 32K→128K | ~145GB | 多卡 | 上一代旗舰 |
| GPT-4.1-mini / Claude Sonnet 4 | 闭源 | --- | 闭源 API | --- | --- | --- | 能力对照(非本地) |
数据来源:参数量/上下文/许可证来自各 HF 模型卡与 open-llm-radar;显存与量化体积来自 llmrun、llmapi、DevQuasar GGUF 仓库(部分为估算,"est." 行以实测上传为准)。能力定位(≈GPT-4.1-mini / Sonnet 4)来自 doubleword 等第三方评测综述,作方向参考。
下面是 Instruct 与 Thinking 两个变体的官方(vendor-reported)基准,取自 Qwen3-VL Technical Report:
| 基准 | 30B-A3B-Instruct | 30B-A3B-Thinking | 维度 |
|---|---|---|---|
| MMMU | 74.2 | 76.0 | 综合视觉 |
| MMMU-Pro | 60.4 | 63.0 | 综合视觉 |
| MathVision | 60.2 | 65.7 | 视觉数学 |
| DocVQA(test) | 95.0 | 95.5 | 文档 OCR |
| VideoMME(无字幕) | 74.5 | 73.3 | 视频 |
| OCRBench | 903 | 839 | 文档 |
生成质量看三个维度:吞吐 ------MoE 每 token 只激活 3.3B,llmrun 社区实测 Q4_K_M 在 RTX 3090 上约 153 tok/s(单一数据点,待复现);vLLM 双卡 BF16 走持续批处理,多并发吞吐远高于 transformers 单请求;显存 ------BF16 全量约 62GB(需双 80GB 或双 24GB offload),AWQ 4-bit 约 18GB 可单 24GB 卡,Q4_K_M GGUF 约 18.6GB 是消费级甜点;理解质量------Instruct 在 MMMU 74.2、DocVQA 95、OCRBench 903 同级开源靠前,长板在"长视频时序定位 + 多语言 OCR + GUI 智能体 + 视觉编码",这些是真实流水线痛点,而非单纯美学跑分。Thinking 变体在多步推理(MathVision 65.7、MMMU 76)更猛,但更慢、更适合"先想后答"的复杂任务。
为什么 MoE 是这次最该关注的点?因为传统"想要更强理解力"就得堆稠密参数、显存线性暴涨;Qwen3-VL-30B-A3B 用稀疏激活把"知识容量"和"推理开销"拆开------你拿到 30B 级别的理解,却只付 3B 级别的每 token 算力,单卡 24GB 量化即可落地。对想本地私有化多模态、又卡在显卡预算的团队,这是结构性的性价比窗口。
数据口径提醒:MMMU / DocVQA / OCRBench / VideoMME 等分数为 Qwen 官方 Technical Report 的 vendor-reported 结果,非第三方盲测,作方向性参考;吞吐与显存除 llmrun 单一社区实测外,其余为厂商/社区口径且标注来源;本文未做本机实测,显存与速度请读者按硬件自查。
结论:Qwen3-VL-30B-A3B 是 2026 年最值得本地落地的开源多模态权重之一------30B 容量 + 3B 激活 + 原生 256K + 视频秒级定位,且 Apache 2.0 真商用自由;和同周被研究的 Qwen-Image-2.1(仅研究许可、且是生图模型)正好互补:一个管"看懂世界",一个管"画出来"。选型时记住:要最强推理选 Thinking 变体,要低延迟生产选 Instruct,要单卡落地优先 Q4_K_M / AWQ 4-bit。
五、使用建议
部署档位速查:
-
12--16GB 显卡:Q2_K / Q3_K_M GGUF(~11--15GB)+ Ollama / LM Studio,开 offload;注意多模态 mmproj 投影器另占约 1GB
-
24GB 单卡:AWQ 4-bit(~18GB)走 vLLM 单卡,或 Q4_K_M GGUF;BF16 全量需 CPU offload(慢)
-
双卡 / 集群:vLLM 或 SGLang,
--tensor-parallel-size 2,BF16 全量 + 持续批处理提吞吐,走/v1/chat/completionsOpenAI 兼容接口 -
Mac / 无独显:MLX 4-bit(~18.3GB,仅 Thinking 有官方 MLX)或 llama.cpp,统一内存机型更友好
-
适用场景:文档/票据/表格 OCR 与结构化抽取;长视频摘要与"第几秒发生什么"时序问答;GUI/App 智能体自动化(RPA);从截图/草图生成前端代码(视觉编码);私有化多模态客服/审核。
-
不适用场景:需要闭源榜首画质或最强推理(Thinking 变体更强但更慢,闭源 GPT-4.1 级仍略领先综合);纯文生图/生视频(它是理解模型,不出图不出视频);8GB 以下显存硬跑全精度(必须量化)。
-
调优提示 :① 多模态 GGUF 务必配套 mmproj 投影器,否则模型"看不见"图;②
image_patch_size=16(Qwen3-VL 专属,填 14 会错位);③ 视频用fps/max_frames控制 token 数,长视频先把 fps 压到 1.0 再说;④ 显存吃紧优先量化主干(Q4_K_M 甜点),BF16 全量留给双卡;⑤generate后一定out[len(inp):]裁输入前缀,否则输出会夹带 prompt。