diff --git a/docs/cookbook/diffusion/Cosmos/Cosmos3.mdx b/docs/cookbook/diffusion/Cosmos/Cosmos3.mdx
index c539ca457a..644fac68be 100644
--- a/docs/cookbook/diffusion/Cosmos/Cosmos3.mdx
+++ b/docs/cookbook/diffusion/Cosmos/Cosmos3.mdx
@@ -1,5 +1,6 @@
---
title: Cosmos3
+description: "Serve NVIDIA Cosmos3 image, video, sound, and action generation with SGLang Diffusion."
metatags:
description: "Serve NVIDIA Cosmos3 image, video, sound, and action generation with SGLang Diffusion."
---
@@ -8,7 +9,43 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/nvidia/cosmos3.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Choose a [generation or policy request](#4-openai-compatible-requests) matching the checkpoint; the Request tab queries model metadata.
+
+
+
+
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
+
+Cosmos3 guardrails are enabled by default when the package is available:
+
+```bash Command
+pip install "cosmos-guardrail==0.3.1"
+```
+
+`cosmos-guardrail` downloads gated NVIDIA guardrail weights, so pass a Hugging Face token if your environment needs one. If the package is not installed, SGLang skips Cosmos3 guardrails and logs a warning. To disable Cosmos3 guardrails for local experiments, set `SGLANG_DISABLE_COSMOS3_GUARDRAILS=1` before starting the server.
+
+There may be problems loading the Cosmos-1.0-Guardrail weights on Ascend NPU. If the *_pickle.UnpicklingError* error occurs during startup, you should change ```weight_only=True``` to ```weights_only=False``` parameter in *cosmos_guardrail/cosmos_utils.py*:
+```
+#!/usr/bin/env bash
+COSMOS_GUARDRAIL_DIR="$(dirname "$(python -c 'import cosmos_guardrail; print(cosmos_guardrail.__file__)')")"
+sed -i 's/weights_only=True/weights_only=False/g' "$COSMOS_GUARDRAIL_DIR/cosmos_utils.py"
+```
+
+
+
+
+
+
+
+## 2. Model capabilities
[NVIDIA Cosmos3](https://huggingface.co/collections/nvidia/cosmos3) is an omnimodal world-model family spanning text/image/video generation, optional synchronized sound, and robot action prediction. Its main advantage is breadth: the same native SGLang pipeline can serve media-generation checkpoints and the DROID policy checkpoint without routing through an LLM sampler.
@@ -30,24 +67,6 @@ Sound and action generation require the corresponding checkpoint heads. The pipe
The default `flow_shift` is `3.0` for T2I, `10.0` for non-Edge video and all action modes, and `3.0` for Edge video modes. Distilled checkpoints bake the schedule into their sigmas and do not use a request-level `flow_shift`.
-## 2. Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
-Cosmos3 guardrails are enabled by default when the package is available:
-
-```bash Command
-pip install "cosmos-guardrail==0.3.1"
-```
-
-`cosmos-guardrail` downloads gated NVIDIA guardrail weights, so pass a Hugging Face token if your environment needs one. If the package is not installed, SGLang skips Cosmos3 guardrails and logs a warning. To disable Cosmos3 guardrails for local experiments, set `SGLANG_DISABLE_COSMOS3_GUARDRAILS=1` before starting the server.
-
-There may be problems loading the Cosmos-1.0-Guardrail weights on Ascend NPU. If the *_pickle.UnpicklingError* error occurs during startup, you should change ```weight_only=True``` to ```weights_only=False``` parameter in *cosmos_guardrail/cosmos_utils.py*:
-```
-#!/usr/bin/env bash
-COSMOS_GUARDRAIL_DIR="$(dirname "$(python -c 'import cosmos_guardrail; print(cosmos_guardrail.__file__)')")"
-sed -i 's/weights_only=True/weights_only=False/g' "$COSMOS_GUARDRAIL_DIR/cosmos_utils.py"
-```
## 3. Serve Cosmos3
Serve `Cosmos3-Nano` directly from the Hugging Face model ID:
diff --git a/docs/cookbook/diffusion/Ernie-Image/Ernie-Image.mdx b/docs/cookbook/diffusion/Ernie-Image/Ernie-Image.mdx
index 0e31e20c50..d5f1785a46 100644
--- a/docs/cookbook/diffusion/Ernie-Image/Ernie-Image.mdx
+++ b/docs/cookbook/diffusion/Ernie-Image/Ernie-Image.mdx
@@ -1,5 +1,6 @@
---
title: ERNIE-Image
+description: "Deploy ERNIE-Image and ERNIE-Image-Turbo with SGLang Diffusion."
metatags:
description: "Deploy ERNIE-Image and ERNIE-Image-Turbo with SGLang Diffusion."
---
@@ -8,7 +9,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/baidu/ernie-image.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[ERNIE-Image](https://huggingface.co/baidu/ERNIE-Image) is Baidu's text-to-image family with separate standard and Turbo checkpoints. The standard model is the quality-oriented path; Turbo is the lower-latency choice, and both load through SGLang's native `ErnieImagePipeline`.
@@ -19,10 +33,6 @@ This integration currently targets text-only image generation rather than image
| ERNIE-Image | `baidu/ERNIE-Image` | Regular text-to-image checkpoint |
| ERNIE-Image-Turbo | `baidu/ERNIE-Image-Turbo` | Turbo text-to-image checkpoint |
-## 2. Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Serve the model
The commands below target a single supported NVIDIA CUDA or AMD ROCm GPU. Start with `--performance-mode auto`; use `speed` only when the full pipeline fits comfortably on the selected GPU(s), and use `memory` when you need lower peak GPU memory.
diff --git a/docs/cookbook/diffusion/FLUX/FLUX.mdx b/docs/cookbook/diffusion/FLUX/FLUX.mdx
index e39331666b..15d231228d 100644
--- a/docs/cookbook/diffusion/FLUX/FLUX.mdx
+++ b/docs/cookbook/diffusion/FLUX/FLUX.mdx
@@ -1,15 +1,28 @@
---
title: FLUX
+description: "Deploy FLUX diffusion models with SGLang - 12B/32B rectified flow transformers for high-quality text-to-image generation."
metatags:
description: "Deploy FLUX diffusion models with SGLang - 12B/32B rectified flow transformers for high-quality text-to-image generation."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { FluxDeployment } from '/src/snippets/diffusion/flux-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/BlackForestLabs/flux.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[FLUX](https://blackforestlabs.ai/) is Black Forest Labs' rectified-flow image model family. [FLUX.1-dev](https://huggingface.co/black-forest-labs/FLUX.1-dev) is the smaller 12B text-to-image checkpoint; [FLUX.2-dev](https://huggingface.co/black-forest-labs/FLUX.2-dev) is a 32B model that adds instruction-based editing plus single- and multi-reference composition.
@@ -20,12 +33,6 @@ FLUX is a strong default when prompt adherence, polished image quality, or refer
| `black-forest-labs/FLUX.1-dev` | High-quality text-to-image with the lighter FLUX deployment | No native multi-reference editing path |
| `black-forest-labs/FLUX.2-dev` | Text-to-image, editing, and reference-guided composition in one model | 32B model with a larger memory footprint |
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -34,9 +41,7 @@ This section provides deployment configurations optimized for different hardware
FLUX models are optimized for high-quality image generation. The recommended launch configurations vary by hardware and model version.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform and model version. SGLang supports serving FLUX on NVIDIA B200, H200, H100, and AMD MI355X, MI325X, MI300X GPUs, Ascend A2, A3 NPUs Series NPUs and Intel Arc B-series graphics(codename: BMG (Battlemage)).
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/Ideogram/Ideogram4.mdx b/docs/cookbook/diffusion/Ideogram/Ideogram4.mdx
index 7b46738e25..32294dbf5e 100644
--- a/docs/cookbook/diffusion/Ideogram/Ideogram4.mdx
+++ b/docs/cookbook/diffusion/Ideogram/Ideogram4.mdx
@@ -1,5 +1,6 @@
---
title: Ideogram 4
+description: "Deploy Ideogram 4 with SGLang Diffusion for high-aesthetic text-to-image generation."
metatags:
description: "Deploy Ideogram 4 with SGLang Diffusion for high-aesthetic text-to-image generation."
---
@@ -8,7 +9,31 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Ideogram/ideogram4.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Set `HF_TOKEN` with access to the gated Ideogram repositories. Install `bitsandbytes>=0.46.1` and `accelerate>=1.1.0` for NF4 and the shared NF4 text encoder.
+
+
+
+
+
+- NVIDIA CUDA GPU.
+- SGLang installed with diffusion dependencies.
+- `bitsandbytes>=0.46.1` and `accelerate>=1.1.0` for the NF4 checkpoint and the fal variants' shared NF4 text encoder.
+- `HF_TOKEN` with access to the Ideogram 4 gated repositories.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Ideogram 4](https://huggingface.co/ideogram-ai/ideogram-4-nf4) is a text-to-image family focused on polished composition and typography-aware generation. SGLang supports the official NF4 and FP8 checkpoints, Comfy-Org's NVFP4 transformer, and fal's distilled Fast and Instant variants.
@@ -24,13 +49,6 @@ Choose NF4 when memory is the primary constraint, FP8/NVFP4 for supported accele
The fal repositories contain only the transformer component. When either model ID is passed directly to `--model-path`, SGLang loads the text encoder, tokenizer, VAE, and scheduler from the `ideogram-ai/ideogram-4-nf4-diffusers` revision referenced by fal's model cards, then runs the distilled transformer without the unconditional branch.
-## 2. Prerequisites
-
-- NVIDIA CUDA GPU.
-- SGLang installed with diffusion dependencies.
-- `bitsandbytes>=0.46.1` and `accelerate>=1.1.0` for the NF4 checkpoint and the fal variants' shared NF4 text encoder.
-- `HF_TOKEN` with access to the Ideogram 4 gated repositories.
-
## 3. Serve the model
NF4:
diff --git a/docs/cookbook/diffusion/JoyEcho/JoyEcho.mdx b/docs/cookbook/diffusion/JoyEcho/JoyEcho.mdx
index cdf52a4b47..d6c98aeb39 100644
--- a/docs/cookbook/diffusion/JoyEcho/JoyEcho.mdx
+++ b/docs/cookbook/diffusion/JoyEcho/JoyEcho.mdx
@@ -9,7 +9,22 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/JoyAI/joyecho.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Prepare the [pinned Echo 1.0 checkpoint](#3-1-prepare-the-echo-1-0-checkpoint) and set `JOY_ECHO_MODEL_PATH` before starting the server.
+
+
+
+
+
+
+
+## 2. Model capabilities
[JoyAI-Echo](https://huggingface.co/jdopensource/JoyAI-Echo) is an 8-step long-form audio-video model built on LTX-2. Its paired memory bank carries decoded visual context and audio latents across prompt changes, making it strongest for multi-shot, minute-scale sequences that need continuity in both picture and soundtrack.
@@ -29,10 +44,6 @@ SGLang materializes the Echo 1.0 monolithic release through the built-in [JoyAI-
Review the model license on the [JoyAI-Echo Hugging Face page](https://huggingface.co/jdopensource/JoyAI-Echo) before production or commercial use. SGLang support does not grant additional model usage rights.
-## 2. SGLang-diffusion Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Model Deployment
### 3.1 Prepare the Echo 1.0 checkpoint
diff --git a/docs/cookbook/diffusion/Krea/Krea-2.mdx b/docs/cookbook/diffusion/Krea/Krea-2.mdx
index afc40cfea5..3ef02f15e3 100644
--- a/docs/cookbook/diffusion/Krea/Krea-2.mdx
+++ b/docs/cookbook/diffusion/Krea/Krea-2.mdx
@@ -1,5 +1,6 @@
---
title: Krea-2
+description: "Deploy Krea-2 with SGLang - fast, high-quality text-to-image generation."
metatags:
description: "Deploy Krea-2 with SGLang - fast, high-quality text-to-image generation."
---
@@ -8,7 +9,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Krea/krea2.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Krea-2](https://huggingface.co/krea/Krea-2-Turbo) is Krea's photorealistic text-to-image family, built as a single-stream MMDiT with a Qwen3-VL text encoder and Qwen-Image VAE. Both public variants use the same native SGLang pipeline and differ mainly in their sampling target.
@@ -19,12 +33,6 @@ Choose Turbo for interactive generation: it is distilled to 8 steps with `guidan
| Turbo | `krea/Krea-2-Turbo` | 8 steps, no CFG; fastest path |
| Raw | `krea/Krea-2-Raw` | About 52 steps with CFG; higher-fidelity path |
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section covers deploying Krea-2-Turbo for fast, high-quality image generation.
diff --git a/docs/cookbook/diffusion/LTX/LTX2 & LTX2.3.mdx b/docs/cookbook/diffusion/LTX/LTX2 & LTX2.3.mdx
index 241e1b055a..b1ccc08ffa 100644
--- a/docs/cookbook/diffusion/LTX/LTX2 & LTX2.3.mdx
+++ b/docs/cookbook/diffusion/LTX/LTX2 & LTX2.3.mdx
@@ -6,11 +6,23 @@ metatags:
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { LTXDeployment } from '/src/snippets/diffusion/ltx-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Lightricks/ltx2.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[LTX-2](https://huggingface.co/Lightricks/LTX-2) and [LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) are Lightricks video models for text-to-video and image-conditioned generation. Their defining deployment choice is the pipeline: one-stage minimizes latency, standard two-stage refines quality, and LTX-2.3 adds a 1920×1088 HQ path.
@@ -22,10 +34,6 @@ Use `Lightricks/LTX-2` or `Lightricks/LTX-2.3` as `--model-path`. SGLang loads t
**License notice:** LTX-2 and LTX-2.3 are released under the LTX-2 Community License Agreement, not Apache 2.0. The license includes commercial-use restrictions for some entities. Review the [official Lightricks license](https://huggingface.co/Lightricks/LTX-2.3/blob/main/LICENSE) before production or commercial use; SGLang support does not grant additional model usage rights.
-## 2. SGLang-diffusion Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different LTX pipelines and hardware targets.
@@ -34,9 +42,7 @@ This section provides deployment configurations optimized for different LTX pipe
The LTX series supports one-stage and two-stage pipelines. LTX-2.3 also supports the HQ two-stage pipeline. The recommended launch configuration depends on whether the target GPU can keep both two-stage DiTs resident.
-**Interactive Command Generator**: Use the configuration selector below to generate a deployment command. The default selection targets a single NVIDIA H200 with `resident` two-stage mode. For multi-GPU serving, start from the 2-GPU or 4-GPU presets and only change parallelism if you need more memory headroom.
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/LTX/LTX2.5.mdx b/docs/cookbook/diffusion/LTX/LTX2.5.mdx
index ee867b52a2..7b760058e9 100644
--- a/docs/cookbook/diffusion/LTX/LTX2.5.mdx
+++ b/docs/cookbook/diffusion/LTX/LTX2.5.mdx
@@ -6,11 +6,36 @@ metatags:
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { LTX25Deployment } from '/src/snippets/diffusion/ltx25-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Lightricks/ltx25.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
+
+NATTEN is an optional extra, worth installing only if you plan to use the
+[diffusion decoder](#4-6-diffusion-decoder) — see that section for why.
+
+
+
+
+
+To use diffusion decoding, load **Diffusion decoder weights** in Server, then
+select **Diffusion** in Request. Duration and decoder selection are request-time
+choices; loading the optional decoder requires a server restart.
+
+
+
+## 2. Model capabilities
[LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5) is an open world model from
Lightricks, built for local execution and fine-tuning. Its established use is
@@ -31,7 +56,9 @@ before production or commercial use; SGLang support does not grant additional
model usage rights.
-### 1.1 New in LTX-2.5
+
+
+### 2.1 New in LTX-2.5
Two capabilities have no equivalent in LTX-2 / LTX-2.3:
@@ -49,7 +76,9 @@ Two capabilities have no equivalent in LTX-2 / LTX-2.3:
Both are optional and off by default.
-### 1.2 Components
+
+
+### 2.2 Components
| Path | Component | Used by |
| --- | --- | --- |
@@ -64,13 +93,6 @@ Both are optional and off by default.
Encoding always uses `vae/`, and both decoders consume the same latents, so the
decoder choice does not change anything upstream of it.
-## 2. SGLang-diffusion Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
-NATTEN is an optional extra, worth installing only if you plan to use the
-[diffusion decoder](#4-6-diffusion-decoder) — see that section for why.
-
## 3. Model Deployment
### 3.1 Basic Configuration
@@ -83,13 +105,7 @@ sglang serve \
On a single high-VRAM GPU no extra flags are needed.
-**Interactive Command Generator**: pick a target and the features you want; the
-command updates below. Server-side choices (pipeline class, weights variant,
-parallelism) go on `sglang serve`, while per-request choices (auto-duration,
-diffusion decoder, resolution) are listed separately, since they belong on the
-`sglang generate` call or the request body.
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/LingBot-Video/LingBot-Video-MoE.mdx b/docs/cookbook/diffusion/LingBot-Video/LingBot-Video-MoE.mdx
index 22c5effdb9..dba2ce62ab 100644
--- a/docs/cookbook/diffusion/LingBot-Video/LingBot-Video-MoE.mdx
+++ b/docs/cookbook/diffusion/LingBot-Video/LingBot-Video-MoE.mdx
@@ -9,7 +9,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/LingBot/lingbot-video.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[LingBot Video MoE 30B-A3B](https://huggingface.co/robbyant/lingbot-video-moe-30b-a3b)
is a text-to-video mixture-of-experts model served through a native SGLang
@@ -32,10 +45,6 @@ The checkpoint expects a structured JSON caption rather than an unexpanded
natural-language prompt. The JSON is passed as the request's `prompt` string;
it is not an `extra_params` object.
-## 2. Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Serve LingBot Video MoE
Start the server with the Hugging Face model ID:
diff --git a/docs/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx b/docs/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx
index b81759b7b0..51155544bd 100644
--- a/docs/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx
+++ b/docs/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx
@@ -1,5 +1,6 @@
---
title: LingBot World 2.0
+description: "Serve LingBot World 2.0 realtime camera-controlled video world models with SGLang-diffusion."
metatags:
description: "Serve LingBot World 2.0 realtime camera-controlled video world models with SGLang-diffusion."
tag: REALTIME
@@ -9,13 +10,28 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/LingBot/lingbot-world2.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Use the [Realtime WebUI](#3-realtime-webui) to start a camera-controlled session. The Request tab checks model metadata; video generation uses WebSocket, not an HTTP POST.
+
+
+
+
+
+## 2. Model capabilities
[LingBot World 2.0](https://huggingface.co/robbyant/lingbot-world-v2-14b-causal-fast-diffusers) is the 14B realtime camera-controlled world model in the LingBot family. It generates continuously from a live causal session, accepts control updates between chunks, and reuses DiT and VAE state for incremental frame delivery.
Choose 2.0 when the larger model and interactive KV-window path justify an 8-GPU deployment. Like the earlier LingBot release, it prioritizes responsive control and bounded causal state over the full-clip global context of offline video diffusion.
-## 2. Deployment
+
+
+## 3. Deployment
```bash Command
export SGLANG_LINGBOT_LAZY_VAE_ENCODE_BLACK_FRAMES=60
@@ -42,7 +58,9 @@ The current and most recent completed chunks remain in BF16. See
for the algorithm, tuning options, measured memory-latency tradeoff, and
support limits.
-## 3. Realtime WebUI
+
+
+## 4. Realtime WebUI
The lightweight local WebUI is useful for validating latency, frame transport, and camera control behavior.
@@ -56,7 +74,9 @@ Open `http://127.0.0.1:18080` and use:
ws://127.0.0.1:30000/v1/realtime_video/generate
```
-## 4. HTTP and WebSocket API
+
+
+## 5. HTTP and WebSocket API
LingBot World 2.0 uses the realtime video WebSocket endpoint. The server keeps one live session, generates one chunk at a time, and accepts runtime control events while generation is running.
@@ -175,17 +195,23 @@ ws.send_binary(msgspec.msgpack.encode({
}))
```
-## 5. Consistency
+
+
+## 6. Consistency
LingBot World 2.0 uses raw-frame websocket GT plus per-chunk latency guards for consistency checks.
-## 6. Notes
+
+
+## 7. Notes
- Use the realtime endpoint for interactive sessions: `/v1/realtime_video/generate`.
- Prefer WebP preview transport for interactive testing; use raw-frame transport for consistency checks.
- Long-running sessions should be validated with raw-frame consistency before changing causal cache, condition sampling, or VAE decode behavior.
-## 7. Run in ComfyUI
+
+
+## 8. Run in ComfyUI
import { ComfyUISupport } from '/src/snippets/diffusion/comfyui-support.jsx';
diff --git a/docs/cookbook/diffusion/LingBot-World/LingBot-World.mdx b/docs/cookbook/diffusion/LingBot-World/LingBot-World.mdx
index 1f3e47d55b..8d43bebaab 100644
--- a/docs/cookbook/diffusion/LingBot-World/LingBot-World.mdx
+++ b/docs/cookbook/diffusion/LingBot-World/LingBot-World.mdx
@@ -1,5 +1,6 @@
---
title: LingBot World
+description: "Serve LingBot World realtime camera-controlled video world models with SGLang-diffusion."
metatags:
description: "Serve LingBot World realtime camera-controlled video world models with SGLang-diffusion."
tag: REALTIME
@@ -9,13 +10,28 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/LingBot/lingbot-world.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Use the [Realtime WebUI](#3-realtime-webui) to start a camera-controlled session. The Request tab checks model metadata; video generation uses WebSocket, not an HTTP POST.
+
+
+
+
+
+## 2. Model capabilities
[LingBot World](https://huggingface.co/robbyant/lingbot-world-fast-diffusers) is a realtime camera-controlled video world model. It keeps a live causal session, applies prompt and camera events between chunks, reuses DiT/VAE state, and streams decoded frames instead of finishing a bounded clip before returning.
Choose it for interactive exploration and continuous control, not one-shot cinematic generation. The causal window makes long sessions practical but gives up the global bidirectional context available to offline Wan or LTX pipelines; session state and cache policy are therefore part of the serving contract.
-## 2. Deployment
+
+
+## 3. Deployment
```bash Command
sglang serve \
@@ -37,7 +53,9 @@ The current and most recent completed chunks remain in BF16. See
for the algorithm, tuning options, measured memory-latency tradeoff, and
support limits.
-## 3. Realtime WebUI
+
+
+## 4. Realtime WebUI
The lightweight local WebUI is useful for validating latency, frame transport, and camera control behavior.
@@ -51,7 +69,9 @@ Open `http://127.0.0.1:18080` and use:
ws://127.0.0.1:30000/v1/realtime_video/generate
```
-## 4. HTTP and WebSocket API
+
+
+## 5. HTTP and WebSocket API
LingBot World uses the realtime video WebSocket endpoint. The server keeps one live session, generates one chunk at a time, and accepts runtime control events while generation is running.
@@ -150,17 +170,23 @@ ws.send_binary(msgspec.msgpack.encode({
}))
```
-## 5. Consistency
+
+
+## 6. Consistency
LingBot World uses raw-frame websocket GT plus per-chunk latency guards for consistency checks.
-## 6. Notes
+
+
+## 7. Notes
- Use the realtime endpoint for interactive sessions: `/v1/realtime_video/generate`.
- Prefer WebP preview transport for interactive testing; use raw-frame transport for consistency checks.
- Long-running sessions should be validated with raw-frame consistency before changing causal cache, condition sampling, or VAE decode behavior.
-## 7. Run in ComfyUI
+
+
+## 8. Run in ComfyUI
import { ComfyUISupport } from '/src/snippets/diffusion/comfyui-support.jsx';
diff --git a/docs/cookbook/diffusion/LongCat/LongCat-Image.mdx b/docs/cookbook/diffusion/LongCat/LongCat-Image.mdx
index 4c56504a3a..d4cae8c7dd 100644
--- a/docs/cookbook/diffusion/LongCat/LongCat-Image.mdx
+++ b/docs/cookbook/diffusion/LongCat/LongCat-Image.mdx
@@ -1,5 +1,6 @@
---
title: LongCat-Image
+description: "Deploy LongCat-Image with SGLang Diffusion and its native in-process Qwen2.5-VL prompt rewriter."
metatags:
description: "Deploy LongCat-Image with SGLang Diffusion and its native in-process Qwen2.5-VL prompt rewriter."
---
@@ -8,7 +9,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/LongCat/longcat-image.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[LongCat-Image](https://huggingface.co/meituan-longcat/LongCat-Image) is a
text-to-image model from Meituan. SGLang runs its Qwen2.5-VL prompt rewriter
@@ -18,10 +32,6 @@ The native pipeline keeps prompt rewriting and diffusion behind one OpenAI-compa
image endpoint. Rewriting is enabled by default for stronger prompt expansion, but
each request can disable it when lower latency matters more than the rewritten prompt.
-## 2. Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Serve the model
```bash Command
diff --git a/docs/cookbook/diffusion/LongLive/LongLive-2.0.mdx b/docs/cookbook/diffusion/LongLive/LongLive-2.0.mdx
index 0d9a8363df..0d487172e7 100644
--- a/docs/cookbook/diffusion/LongLive/LongLive-2.0.mdx
+++ b/docs/cookbook/diffusion/LongLive/LongLive-2.0.mdx
@@ -7,7 +7,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/nvidia/longlive2.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[LongLive 2.0](https://nvlabs.github.io/LongLive/LongLive2/) is NVIDIA's 4-step text/image-to-video model distilled from Wan2.2-TI2V-5B. Its main strength is extending few-step causal generation across prompt changes, so a single request can produce multi-shot sequences without paying a full diffusion schedule for every shot.
@@ -15,10 +28,6 @@ Choose it for low-step long or multi-shot generation rather than maximum one-sho
The model weights use the NVIDIA Open Model License. See the [paper](https://arxiv.org/abs/2605.18739) and [GitHub repository](https://github.com/NVlabs/LongLive) for training details.
-## 2. SGLang-diffusion Installation
-
-Please refer to the [official SGLang-diffusion installation guide](/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Deployment
```bash Command
diff --git a/docs/cookbook/diffusion/MOVA/MOVA.mdx b/docs/cookbook/diffusion/MOVA/MOVA.mdx
index 2f9c9aa743..92227367e6 100644
--- a/docs/cookbook/diffusion/MOVA/MOVA.mdx
+++ b/docs/cookbook/diffusion/MOVA/MOVA.mdx
@@ -1,5 +1,6 @@
---
title: MOVA
+description: "Deploy MOVA with SGLang - simultaneous video and audio generation with asymmetric dual-tower architecture, precise lip-sync, and environment-aware sound effects."
metatags:
description: "Deploy MOVA with SGLang - simultaneous video and audio generation with asymmetric dual-tower architecture, precise lip-sync, and environment-aware sound effects."
---
@@ -8,7 +9,27 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/OpenMOSS/mova.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+Set the output directory before starting the server:
+
+```bash
+export SG_OUTPUT_DIR=/root/output_mova
+mkdir -p "$SG_OUTPUT_DIR"
+```
+
+
+
+
+
+
+
+## 2. Model capabilities
[MOVA](https://github.com/OpenMOSS/MOVA) generates video and audio together with an asymmetric dual-tower model connected by bidirectional cross-attention. Its strongest use cases are speaking subjects, visible sound-producing events, and scenes where ambient audio must track the picture rather than be synthesized by a later cascade.
@@ -19,12 +40,6 @@ The public 360p and 720p checkpoints both generate up to 8 seconds. Choose 360p
| `OpenMOSS-Team/MOVA-360p` | Faster, lower-memory joint audiovisual generation | Up to 8 seconds at 360p |
| `OpenMOSS-Team/MOVA-720p` | Higher-resolution lip-sync and environment audio | Up to 8 seconds at 720p |
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -33,11 +48,8 @@ This section provides deployment configurations optimized for different hardware
MOVA supports both online serving and CLI generation modes. The recommended launch configurations vary by hardware and resolution.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform.
-import { MOVADeployment } from '/src/snippets/diffusion/mova-deployment.jsx'
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/Qwen-Image/Qwen-Image-Edit.mdx b/docs/cookbook/diffusion/Qwen-Image/Qwen-Image-Edit.mdx
index 5b5c585130..2d4e3f0fb5 100644
--- a/docs/cookbook/diffusion/Qwen-Image/Qwen-Image-Edit.mdx
+++ b/docs/cookbook/diffusion/Qwen-Image/Qwen-Image-Edit.mdx
@@ -1,26 +1,33 @@
---
title: Qwen-Image-Edit-2511
+description: "Deploy Qwen-Image-Edit-2511 with SGLang - 20B image editing model with text rendering, character consistency, and geometric reasoning."
metatags:
description: "Deploy Qwen-Image-Edit-2511 with SGLang - 20B image editing model with text rendering, character consistency, and geometric reasoning."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { QwenImageEditDeployment } from '/src/snippets/diffusion/qwen-image-edit-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Qwen/qwen-image-edit.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Qwen-Image-Edit-2511](https://huggingface.co/Qwen/Qwen-Image-Edit-2511) is the 20B editing counterpart to Qwen-Image. It is strongest at changing text, materials, lighting, viewpoint, or composition while reducing drift in regions that were not requested to change.
Choose it for identity-sensitive portrait edits, multi-person composition, typography replacement, and geometry-aware design work. It is substantially heavier than small specialist editors, and consistency is improved rather than guaranteed; evaluate untouched-region drift on the actual editing workload.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -29,9 +36,7 @@ This section provides deployment configurations optimized for different hardware
Qwen-Image-Edit-2511 is a 20B parameter model optimized for image editing tasks. The recommended launch configurations vary by hardware.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform.
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/Qwen-Image/Qwen-Image.mdx b/docs/cookbook/diffusion/Qwen-Image/Qwen-Image.mdx
index 881dfa9c5e..f3b2c9ec9f 100644
--- a/docs/cookbook/diffusion/Qwen-Image/Qwen-Image.mdx
+++ b/docs/cookbook/diffusion/Qwen-Image/Qwen-Image.mdx
@@ -1,26 +1,33 @@
---
title: Qwen-Image
+description: "Deploy Qwen-Image with SGLang - community contribution guide for Qwen's image generation model."
metatags:
description: "Deploy Qwen-Image with SGLang - community contribution guide for Qwen's image generation model."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { QwenImageDeployment } from '/src/snippets/diffusion/qwen-image-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Qwen/qwen-image.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Qwen-Image](https://huggingface.co/Qwen/Qwen-Image) is a 20B text-to-image model built for strong prompt following and precise rendering of English and Chinese text. It is especially useful for posters, signs, diagrams, and dense layouts where typography and spatial relationships matter as much as general image quality.
This page covers generation rather than editing: use Qwen-Image-Edit when an existing image, subject identity, or untouched region must be preserved. The full checkpoint is memory-heavy, while the validated ModelOpt NVFP4 release provides a supported low-precision deployment option with an expected quality tradeoff.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](../../../docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -29,9 +36,7 @@ This section provides deployment configurations optimized for different hardware
Qwen-Image is a text-to-image model. The recommended launch configurations vary by hardware. SGLang supports serving Qwen-Image on NVIDIA B200, B300, H200, H100, AMD MI300X, MI325X, MI355X GPUs and Ascend A2/A3 Series NPUs.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform.
-
-
+Use the [command builder](#1-quick-start) above.
For the validated ModelOpt NVFP4 checkpoint on Blackwell, load the published
Qwen-Image-2512 NVFP4 repo directly:
diff --git a/docs/cookbook/diffusion/SANA-Video/SANA-Video.mdx b/docs/cookbook/diffusion/SANA-Video/SANA-Video.mdx
index 66006723e7..fd76b41c0d 100644
--- a/docs/cookbook/diffusion/SANA-Video/SANA-Video.mdx
+++ b/docs/cookbook/diffusion/SANA-Video/SANA-Video.mdx
@@ -9,7 +9,20 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/SANA/sana-video.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[SANA-Video 2B 480p](https://huggingface.co/Efficient-Large-Model/SANA-Video_2B_480p_diffusers)
is a lightweight text-to-video model served through a native SGLang Diffusion
@@ -26,10 +39,6 @@ from the prompt with an optional `motion score: N.` suffix.
| --- | --- | --- |
| `Efficient-Large-Model/SANA-Video_2B_480p_diffusers` | Text to video | 832x480, 81 frames at 16 FPS |
-## 2. Installation
-
-Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation). Docker is recommended for Linux GPU deployments; run the commands below inside the container or your installed Python environment.
-
## 3. Serve SANA-Video
```bash Command
diff --git a/docs/cookbook/diffusion/SANA-WM/SANA-WM.mdx b/docs/cookbook/diffusion/SANA-WM/SANA-WM.mdx
index 4983ea663c..ed7d60add5 100644
--- a/docs/cookbook/diffusion/SANA-WM/SANA-WM.mdx
+++ b/docs/cookbook/diffusion/SANA-WM/SANA-WM.mdx
@@ -1,5 +1,6 @@
---
title: SANA-WM
+description: "Deploy SANA-WM with SGLang - a camera-controlled text+image-to-video world model with WASD/IJKL 6-DoF camera control, served three ways: dense bidirectional and chunk-causal batch streaming over /v1/videos (SanaWMTwoStagePipeline), and live over a realtime WebSocket API (SanaWMRealtimePipeline, /v1/realtime_video/generate)."
metatags:
description: "Deploy SANA-WM with SGLang - a camera-controlled text+image-to-video world model with WASD/IJKL 6-DoF camera control, served three ways: dense bidirectional and chunk-causal batch streaming over /v1/videos (SanaWMTwoStagePipeline), and live over a realtime WebSocket API (SanaWMRealtimePipeline, /v1/realtime_video/generate)."
---
@@ -8,7 +9,30 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/SANA/sana-wm.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+For realtime mode, use the [WebSocket client](#7-realtime-websocket-api); the Request tab only checks model metadata in that mode.
+
+
+
+
+
+SGLang-diffusion offers multiple installation methods depending on your hardware platform. Please refer to the [SGLang Diffusion installation guide](../../../docs/sglang-diffusion/installation).
+
+SANA-WM adds the `SanaWMTransformer3DModel` + GDN kernels, the `SanaWMTwoStagePipeline` (dense bidirectional + chunk-causal streaming), and the `SanaWMRealtimePipeline` with the `/v1/realtime_video` WebSocket router. Use `sglang serve` to launch the diffusion server.
+
+
+
+
+
+
+
+## 2. Model capabilities
[SANA-WM](https://huggingface.co/Efficient-Large-Model/SANA-WM_bidirectional) is NVLabs' 2.6B text-and-image-to-video world model for 720p, minute-scale generation with explicit per-frame 6-DoF camera control. Its hybrid recurrent/softmax attention keeps long causal histories bounded, while an LTX-2 refiner supplies the detail that the fast Stage-1 world model does not produce on its own.
@@ -33,12 +57,6 @@ Choose the dense checkpoint for the best bounded-clip quality and the streaming
For architecture and training details, see the [SANA-WM paper](https://arxiv.org/abs/2605.15178) and [model card](https://huggingface.co/Efficient-Large-Model/SANA-WM_bidirectional) (Apache-2.0).
-## 2. Installation
-
-SGLang-diffusion offers multiple installation methods depending on your hardware platform. Please refer to the [SGLang Diffusion installation guide](../../../docs/sglang-diffusion/installation).
-
-SANA-WM adds the `SanaWMTransformer3DModel` + GDN kernels, the `SanaWMTwoStagePipeline` (dense bidirectional + chunk-causal streaming), and the `SanaWMRealtimePipeline` with the `/v1/realtime_video` WebSocket router. Use `sglang serve` to launch the diffusion server.
-
## 3. Model Setup
Both SANA-WM checkpoints are **public** (Apache-2.0, no gating, no token) and load **directly** — there is no manual assembly step. Pass the HuggingFace repo id to `--model-path` and SGLang downloads, materializes, validates, and loads it:
diff --git a/docs/cookbook/diffusion/SenseNova/SenseNova-U1.5-8B-MoT.mdx b/docs/cookbook/diffusion/SenseNova/SenseNova-U1.5-8B-MoT.mdx
index f5006040c1..4d9d915fd1 100644
--- a/docs/cookbook/diffusion/SenseNova/SenseNova-U1.5-8B-MoT.mdx
+++ b/docs/cookbook/diffusion/SenseNova/SenseNova-U1.5-8B-MoT.mdx
@@ -1,5 +1,6 @@
---
title: SenseNova-U1.5-8B-MoT
+description: "Run SenseNova-U1.5-8B-MoT text-to-image generation with SGLang's native multimodal generation runtime."
metatags:
description: "Run SenseNova-U1.5-8B-MoT text-to-image generation with SGLang's native multimodal generation runtime."
---
@@ -8,18 +9,25 @@ import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/SenseNova/sensenova-u15.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[SenseNova-U1.5-8B-MoT](https://huggingface.co/sensenova/SenseNova-U1.5-8B-MoT) is a text-to-image model in the SenseNova-U1 family. It is useful for high-resolution poster, infographic, and enterprise visual-generation workloads where prompt following, layout structure, and Chinese text rendering are important.
Built on [NEO-Unify](https://huggingface.co/blog/sensenova/neo-unify), this release improves composition, color harmony, material rendering, and local visual detail for native high-resolution generation. It also focuses on clearer Chinese and English text rendering, stronger infographic layout structure, and more reliable execution of complex prompts with object counts, spatial relationships, styles, and multiple constraints.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](../../../docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
### 3.1 Offline Image Generation
diff --git a/docs/cookbook/diffusion/Wan/Wan2.1.mdx b/docs/cookbook/diffusion/Wan/Wan2.1.mdx
index db8abc4b1d..95fab54f8b 100644
--- a/docs/cookbook/diffusion/Wan/Wan2.1.mdx
+++ b/docs/cookbook/diffusion/Wan/Wan2.1.mdx
@@ -1,26 +1,33 @@
---
title: Wan2.1
+description: "Deploy Wan2.1 video generation models with SGLang - community contribution guide for Wan Video's diffusion models."
metatags:
description: "Deploy Wan2.1 video generation models with SGLang - community contribution guide for Wan Video's diffusion models."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { Wan21Deployment } from '/src/snippets/diffusion/wan21-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Wan/wan21.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Wan2.1](https://github.com/Wan-Video/Wan2.1) is a broad open video family covering text-to-video and image-to-video across 1.3B and 14B checkpoints. Its practical strengths are motion-rich generation, temporal consistency, and readable Chinese/English text, with 480p and 720p variants for different quality and memory targets.
Choose the 1.3B T2V model for consumer-GPU experiments and the 14B models when quality matters more than footprint. Wan2.1 is a dense DiT family; for timestep-specialized MoE capacity or the unified 5B TI2V path, use Wan2.2 instead.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](../../../docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -29,9 +36,7 @@ This section provides deployment configurations optimized for different hardware
The Wan2.1 series offers models in multiple sizes and resolutions. SGLang supports Wan2.1 deployment on NVIDIA B200, B300, H200, H100, and AMD MI300X, MI325X, MI355X GPUs and Ascend A2/A3 Series NPUs. The recommended launch configurations vary by hardware, model size, and memory headroom.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate an appropriate deployment command for your model variant and options.
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/Wan/Wan2.2.mdx b/docs/cookbook/diffusion/Wan/Wan2.2.mdx
index 3ee5618663..d3b8e29bdf 100644
--- a/docs/cookbook/diffusion/Wan/Wan2.2.mdx
+++ b/docs/cookbook/diffusion/Wan/Wan2.2.mdx
@@ -1,15 +1,28 @@
---
title: Wan2.2
+description: "Deploy Wan2.2 video generation models with SGLang - MoE architecture, cinematic aesthetics, and efficient 720P@24fps generation."
metatags:
description: "Deploy Wan2.2 video generation models with SGLang - MoE architecture, cinematic aesthetics, and efficient 720P@24fps generation."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { Wan22Deployment } from '/src/snippets/diffusion/wan22-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/Wan/wan22.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Wan2.2](https://github.com/Wan-Video/Wan2.2) extends the Wan family with timestep-specialized Mixture-of-Experts models and a unified 5B TI2V checkpoint. It targets cinematic composition, lighting, and complex motion while supporting text-to-video, image-to-video, and hybrid text/image conditioning.
@@ -21,12 +34,6 @@ for image-to-video generation. Use `Wan-AI/Wan2.2-I2V-A14B-Diffusers` when I2V
quality is the priority.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -35,9 +42,7 @@ This section provides deployment configurations optimized for different hardware
The Wan2.2 series offers models in various sizes, architectures and input types, optimized for different hardware platforms. The recommended launch configurations vary by hardware and model size.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform, model size. SGLang supports serving Wan2.2 on NVIDIA B200, H200, AMD MI300X, MI325X, MI355X GPUs and Ascend A2/A3 Series NPUs.
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/cookbook/diffusion/Z-Image/Z-Image-Turbo.mdx b/docs/cookbook/diffusion/Z-Image/Z-Image-Turbo.mdx
index f38c431142..011bbd85e7 100644
--- a/docs/cookbook/diffusion/Z-Image/Z-Image-Turbo.mdx
+++ b/docs/cookbook/diffusion/Z-Image/Z-Image-Turbo.mdx
@@ -1,26 +1,33 @@
---
title: Z-Image-Turbo
+description: "Deploy Z-Image-Turbo with SGLang - community contribution guide for Z-Image's fast image generation model."
metatags:
description: "Deploy Z-Image-Turbo with SGLang - community contribution guide for Z-Image's fast image generation model."
---
import { DiffusionModelTags } from '/src/snippets/diffusion/model-tags.jsx';
-import { ZImageTurboDeployment } from '/src/snippets/diffusion/zimage-turbo-deployment.jsx';
-## 1. Model Introduction
+import { Deployment } from '/src/snippets/_deployment.jsx';
+import { config } from '/src/snippets/configs/TongyiMAI/z-image-turbo.jsx';
+
+## 1. Quick start
+
+Follow the [SGLang Diffusion installation guide](/docs/sglang-diffusion/installation) for your GPU platform.
+
+
+
+
+
+
+
+## 2. Model capabilities
[Z-Image-Turbo](https://huggingface.co/Tongyi-MAI/Z-Image-Turbo) is a distilled 6B single-stream DiT for fast text-to-image generation. It reaches its intended operating point in 8 function evaluations and is particularly strong at photorealistic scenes, prompt adherence, and English/Chinese text rendering.
Choose it when latency and a relatively small deployment footprint matter more than the editability or maximum capacity of larger image models. It is a generation-only checkpoint; use Qwen-Image-Edit or FLUX.2 when the request includes source images or identity-preserving edits.
-## 2. SGLang-diffusion Installation
-
-SGLang-diffusion offers multiple installation methods. You can choose the most suitable installation method based on your hardware platform and requirements.
-
-Please refer to the [official SGLang-diffusion installation guide](https://docs.sglang.io/docs/sglang-diffusion/installation) for installation instructions.
-
## 3. Model Deployment
This section provides deployment configurations optimized for different hardware platforms and use cases.
@@ -29,9 +36,7 @@ This section provides deployment configurations optimized for different hardware
Z-Image-Turbo is optimized for high-quality image generation with only 8 inference steps. The recommended launch configurations vary by hardware.
-**Interactive Command Generator**: Use the configuration selector below to automatically generate the appropriate deployment command for your hardware platform and model version. SGLang supports serving Z-Image-Turbo on NVIDIA B200, H200, H100, and AMD MI355X, MI325X, MI300X GPUs, Ascend A2, A3 NPUs and Intel Arc Pro B-Series GPUs(codename: BMG (Battlemage)).
-
-
+Use the [command builder](#1-quick-start) above.
### 3.2 Configuration Tips
diff --git a/docs/custom.css b/docs/custom.css
index 76fb5d4f9f..7b9f0ebbc3 100644
--- a/docs/custom.css
+++ b/docs/custom.css
@@ -362,6 +362,17 @@ html.dark table tbody tr:nth-child(even) td,
.sgd-builder-controls, .sgd-builder-output-rail { min-width: 0; }
.sgd-builder-controls { container: builder-controls / inline-size; padding: 4px 16px 20px; }
+.sgd-builder-docs-tip {
+ display: block;
+ margin: 0;
+ padding: 12px 16px;
+ border-top: 1px solid var(--sgdb-line);
+ color: var(--sgdb-muted);
+ font-size: 12px;
+ line-height: 1.5;
+}
+.sgd-builder-docs-tip a { color: var(--sgdb-serve); text-decoration: underline; text-underline-offset: 3px; }
+
.sgd-builder-scope-panel { display: grid; gap: 0; }
.sgd-builder-recipe {
display: flex;
diff --git a/docs/scripts/tests/diffusion-builders.test.mjs b/docs/scripts/tests/diffusion-builders.test.mjs
new file mode 100644
index 0000000000..00ee1a7026
--- /dev/null
+++ b/docs/scripts/tests/diffusion-builders.test.mjs
@@ -0,0 +1,214 @@
+import assert from "node:assert/strict";
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import test from "node:test";
+
+const docs = fileURLToPath(new URL("../..", import.meta.url));
+const walk = (dir) =>
+ readdirSync(dir, { withFileTypes: true }).flatMap((entry) =>
+ entry.isDirectory() ? walk(join(dir, entry.name)) : [join(dir, entry.name)],
+ );
+const pages = walk(join(docs, "cookbook/diffusion")).filter((path) => path.endsWith(".mdx"));
+const configs = new Map();
+for (const page of pages) {
+ const content = readFileSync(page, "utf8");
+ const path = content.match(/import\s+\{\s*config\s*\}\s+from\s+["']([^"']+)["']/)?.[1];
+ if (!path) continue;
+ const source = readFileSync(join(docs, path), "utf8");
+ configs.set(page, (await import("data:text/javascript," + encodeURIComponent(source))).config);
+}
+const get = (suffix) => [...configs].find(([path]) => path.endsWith(suffix))[1];
+const selection = (config, overrides = {}) => ({
+ ...config.commandBuilder.defaultSelection,
+ ...Object.fromEntries(config.overlayDims.map((dim) => [dim.id, dim.default])),
+ ...overrides,
+});
+const resolve = (config, overrides = {}) => config.commandBuilder.resolveDeployment(selection(config, overrides));
+const curl = (config, overrides = {}) =>
+ typeof config.curl === "function" ? config.curl(selection(config, overrides)) : config.curl;
+const body = (config, overrides = {}) => JSON.parse(curl(config, overrides).match(/-d '([\s\S]+)'$/)[1]);
+const migrated = [...configs.values()].filter((config) =>
+ config.commandBuilder.resource.verifiedRecipes.some((recipe) => recipe.id.endsWith("-documented")),
+);
+
+test("every diffusion model uses one shared builder before model capabilities", () => {
+ const models = pages.filter((path) => readFileSync(path, "utf8").includes("= 29);
+ for (const page of models) {
+ const content = readFileSync(page, "utf8");
+ const quick = content.indexOf("## 1. Quick start");
+ const builder = content.indexOf("");
+ const capabilities = content.indexOf("## 2. Model capabilities");
+ assert.ok(quick >= 0 && quick < builder && builder < capabilities, page);
+ assert.equal(content.match(/ path.endsWith("-deployment.jsx")));
+});
+
+test("server builder has a footer link to the CLI reference", () => {
+ const shared = readFileSync(join(docs, "src/snippets/_deployment.jsx"), "utf8");
+ assert.match(shared, /builderScope === "serve" && \(\s*