Video-XL-2
BAAIapache-2.0textvisionvideo

Video-XL-2

Updated Nov 21, 2026
Parameters
8.1B
Context
32,768
License
apache-2.0
Updated
Nov 21, 2026

Will it run on your hardware?

Pick your GPU memory - see which quantizations fit, and the cheapest card for the rest

Runs on your 24 GB - best at FP16
4 of 4 quantizations fit Video-XL-2 with real runtime overhead.
Q4_K_M
5 GB
Q5_K_M
6 GB
Q8_0
9 GB
FP16
16 GB
fits tight too big

Need an exact figure for your context length? Use the VRAM calculator.

Run it locally

Copy-paste - running in under a minute

vLLMOpenAI-compatible API
vllm serve BAAI/Video-XL-2

New to this? Start with Ollama · serve to many users with vLLM.

Deep dive

Notes, sources, and the full write-up

Video-XL-2 is an open-weight video understanding model published by BAAI on Hugging Face in May 2025, with 8.1B parameters under the apache-2.0 license.

Among the 16 video understanding models in this directory it ranks 11th by monthly Hugging Face downloads, and 8 of the others are larger.

HardwareLink to this section

Unquantized FP16 weights take about 16 GB; 8-bit brings that to ~9 GB and 4-bit (Q4_K_M) to ~5 GB, before activations and any context or image buffers. A 12 GB consumer card holds it at 4-bit; FP16 needs a 24 GB card such as an RTX 4090. Check exact numbers for your card with the VRAM calculator.

Similar video understanding modelsLink to this section

PopularityLink to this section

Video-XL-2 was downloaded 1,688 times on Hugging Face in the last month (6,896 all-time) and has 58 likes.

Run it locallyLink to this section

Weights and usage instructions are on the BAAI/Video-XL-2 model card; it loads with Hugging Face Transformers.

Local runtimes that fit this model:

  • vllm - high-throughput serving on NVIDIA GPUs
  • transformers - the reference Python library most model cards target

PaperLink to this section

From the community

What users are saying

“why? OSError: BAAI/Video-XL-2 does not appear to have a file named multimodalencoder.builder.py. Checkout 'https://huggingface.co/BAAI/Video-XL-2/tree/main' for available files.”

“Hi Mr.Zhang, We've fixed the problem. Please try again using the following steps: 1. Update inference code: 2. Run updated demo code: 1. Inference w/o. Efficiency Optimization 2. Inference w. Chunk-based Pre-filling”

Frequently asked

Quick answers to common questions

How much VRAM does Video-XL-2 need?

Video-XL-2 with 8.1B parameters needs approximately 5 GB at Q4_K_M quantization. Use our VRAM calculator for an exact estimate.

Is Video-XL-2 better than other BAAI models?

Video-XL-2 has 8.1B parameters with 32,768 context - a strong choice for video-understanding, vision.

What license is Video-XL-2 under?

Video-XL-2 is released under the apache-2.0 license, making it suitable for most commercial and personal projects.

What hardware runs Video-XL-2 well?

With 8.1B parameters, Video-XL-2 requires adequate VRAM. High-end GPUs like the RTX 4090 (24GB), RTX 5090 (32GB), or Mac Studio with unified memory are good options. Check our hardware directory for specific recommendations.

What is the best quantization for Video-XL-2?

Q4_K_M is the recommended sweet spot - ~98% of FP16 quality at ~27% of the size. Q5_K_M (~6 GB) is an option if you have spare VRAM. Use our VRAM calculator to compare.

How long can Video-XL-2's context window handle?

Video-XL-2 supports a 32,768-token context window - enough for most medium-length documents and conversations. Real-world usable context may vary by implementation.

What models compete with Video-XL-2?

Video-XL-2 competes with other models in its class. Browse our model directory for comparisons, benchmarks, and community reviews to find the best fit.

Nearby options

Similar models and compatible hardware by spec