Files
transformers/docs/source/en/model_doc/qwen3_5.md
陈赣 06f1fd69a6
Some checks failed
Self-hosted runner (nightly-past-ci-caller) / Get number (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.11 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.10 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.9 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.8 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.7 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.6 (push) Has been cancelled
Self-hosted runner (nightly-past-ci-caller) / TensorFlow 2.5 (push) Has been cancelled
Self-hosted runner (benchmark) / Benchmark (aws-g5-4xlarge-cache) (push) Has been cancelled
Build documentation / build (push) Has been cancelled
Build documentation / build_other_lang (push) Has been cancelled
CodeQL Security Analysis / CodeQL Analysis (push) Has been cancelled
New model PR merged notification / Notify new model (push) Has been cancelled
PR CI / pr-ci (push) Has been cancelled
Slow tests on important models (on Push - A10) / Get all modified files (push) Has been cancelled
Secret Leaks / trufflehog (push) Has been cancelled
Update Transformers metadata / build_and_package (push) Has been cancelled
Slow tests on important models (on Push - A10) / Model CI (push) Has been cancelled
Check Tiny Models / Check tiny models (push) Has been cancelled
Self-hosted runner (Intel Gaudi3 scheduled CI caller) / Model CI (push) Has been cancelled
Self-hosted runner (Intel Gaudi3 scheduled CI caller) / Pipeline CI (push) Has been cancelled
Self-hosted runner (Intel Gaudi3 scheduled CI caller) / Example CI (push) Has been cancelled
Self-hosted runner (Intel Gaudi3 scheduled CI caller) / DeepSpeed CI (push) Has been cancelled
Self-hosted runner (Intel Gaudi3 scheduled CI caller) / Trainer/FSDP CI (push) Has been cancelled
Nvidia CI - Flash Attn / Setup (push) Has been cancelled
Nvidia CI - Flash Attn / Model CI (push) Has been cancelled
Nvidia CI / Setup (push) Has been cancelled
Nvidia CI / Model CI (push) Has been cancelled
Nvidia CI / Torch pipeline CI (push) Has been cancelled
Nvidia CI / Example CI (push) Has been cancelled
Nvidia CI / Trainer/FSDP CI (push) Has been cancelled
Nvidia CI / DeepSpeed CI (push) Has been cancelled
Nvidia CI / Quantization CI (push) Has been cancelled
Nvidia CI / Kernels CI (push) Has been cancelled
Doctests / Setup (push) Has been cancelled
Doctests / Call doctest jobs (push) Has been cancelled
Doctests / Send results to webhook (push) Has been cancelled
Extras Smoke Test / Get supported Python versions (push) Has been cancelled
Extras Smoke Test / Test extras on Python ${{ matrix.python-version }} (push) Has been cancelled
Extras Smoke Test / Check Slack token availability (push) Has been cancelled
Extras Smoke Test / Notify failures to Slack (push) Has been cancelled
Self-hosted runner (AMD scheduled CI caller) / Trigger Scheduled AMD CI (push) Has been cancelled
Stale Bot / Close Stale Issues (push) Has been cancelled
first commit
2026-06-05 16:53:03 +08:00

4.9 KiB

This model was contributed to Hugging Face Transformers on 2026-02-09.

FlashAttention SDPA

Qwen3.5

Qwen3.5 is Qwen's natively multimodal foundation model family, trained from scratch on interleaved text, image, and video tokens. It uses a 3:1 hybrid attention stack — three Gated DeltaNet (linear attention) layers for every one Gated Attention (full attention) layer — so long context and vision tokens can be served without paying full quadratic cost on every block.

This page covers the dense Qwen3.5 and Qwen3.6 variants (Qwen/Qwen3.5-9B, Qwen/Qwen3.5-27B, Qwen/Qwen3.6-27B). Qwen3.6 checkpoints share the same architecture and model_type as Qwen3.5 and are loaded with the same classes. For the sparse mixture-of-experts variants see Qwen3.5 MoE. The text backbone reuses Qwen3-Next's linear-attention decoder with a three-component multimodal RoPE; the vision tower reuses the Qwen3-VL encoder.

You can find all the official Qwen3.5 checkpoints under the Qwen organization.

Quickstart

import torch
from transformers import pipeline

pipe = pipeline(
    task="text-generation",
    model="Qwen/Qwen3.5-9B",
    device_map="auto",
)
print(pipe("The capital of France is", max_new_tokens=20)[0]["generated_text"])
import torch
from transformers import AutoTokenizer, Qwen3_5ForCausalLM

tokenizer = AutoTokenizer.from_pretrained("Qwen/Qwen3.5-9B")
model = Qwen3_5ForCausalLM.from_pretrained(
    "Qwen/Qwen3.5-9B",
    device_map="auto",
)

inputs = tokenizer("Hey, are you conscious? Can you talk to me?", return_tensors="pt").to(model.device)
generated_ids = model.generate(**inputs, max_new_tokens=30)
print(tokenizer.decode(generated_ids[0], skip_special_tokens=True))

Usage tips and notes

  • Layers are hybrid: [Qwen3_5TextConfig]'s layer_types is a per-layer list of "linear_attention" or "full_attention" that encodes the 3:1 Gated DeltaNet / Gated Attention stack. The DeltaNet path (Qwen3NextGatedDeltaNet) needs the optional causal_conv1d (from Dao-AILab) and fla packages for its fast kernels — without them, the model silently falls back to slower and more memory hungry PyTorch ops.
  • Multimodal RoPE splits the head dimension into three components (temporal, height, width) via mrope_section on the text config. If you replace the rotary module, preserve this split or position encodings for image and video tokens will be misaligned.
  • Use [Qwen3_5ForCausalLM] for text-only generation with [Qwen3_5TextConfig]; use [Qwen3_5ForConditionalGeneration] with the full [Qwen3_5Config] and a processor ([~AutoProcessor.from_pretrained]) to feed interleaved image/video + text via [~ProcessorMixin.apply_chat_template].

Qwen3_5Config

autodoc Qwen3_5Config

Qwen3_5TextConfig

autodoc Qwen3_5TextConfig

Qwen3_5VisionConfig

autodoc Qwen3_5VisionConfig

Qwen3_5Tokenizer

autodoc Qwen3_5Tokenizer

Qwen3_5VisionModel

autodoc Qwen3_5VisionModel - forward

Qwen3_5TextModel

autodoc Qwen3_5TextModel - forward

Qwen3_5Model

autodoc Qwen3_5Model - forward

Qwen3_5ForCausalLM

autodoc Qwen3_5ForCausalLM - forward

Qwen3_5ForConditionalGeneration

autodoc Qwen3_5ForConditionalGeneration - forward <<<<<<< HEAD

Qwen3_5ForSequenceClassification

autodoc Qwen3_5ForSequenceClassification - forward

Qwen3_5TextForSequenceClassification

autodoc Qwen3_5TextForSequenceClassification - forward

Qwen3_5ForTokenClassification

autodoc Qwen3_5ForTokenClassification - forward

Qwen3_5Tokenizer

autodoc Qwen3_5Tokenizer

52b4732861 (docs)