{
  "id": "qwen-image21-vllm-omni",
  "title": "Qwen-Image-2.1: vLLM-Omni recipe",
  "kind": "deployment",
  "source_type": "maintainer_recipe",
  "summary": "Image-generation recipe with vLLM-Omni requirements and separate precision choices.",
  "runtime": "vLLM-Omni",
  "runtime_topics": [
    "vLLM-Omni"
  ],
  "hardware_topics": [
    "nvidia"
  ],
  "platform_topics": [
    "linux"
  ],
  "model_label": "Qwen-Image-2.1",
  "model_family": "Qwen",
  "model_id": "Qwen/Qwen-Image-2.1",
  "model_release_date": null,
  "model_artifact": {
    "id": "Qwen/Qwen-Image-2.1",
    "revision": null,
    "format": "bf16"
  },
  "evidence_state": "source_reported",
  "site_reproduced": false,
  "record_type": "curated_reference",
  "performance_ranking_allowed": false,
  "metrics": null,
  "metrics_status": "site_metrics_unmeasured; attributed_source_figures_in_editorial.reported_results",
  "conditions": {
    "model_revision": null,
    "weight_hash": null,
    "runtime_execution_revision": null,
    "input_tokens": null,
    "output_tokens": null,
    "concurrency": null,
    "cache_state": null,
    "quantization": null,
    "speculative_decoding": null,
    "temperature": null,
    "top_p": null
  },
  "reported_setup": {
    "system": null,
    "node_count": null,
    "parallelism": null,
    "kv_dtype": null,
    "context_limit_tokens": null,
    "experiment_date": null
  },
  "test_profiles": [],
  "deployment_options": [
    {
      "variant": "default",
      "model_id": "Qwen/Qwen-Image-2.1",
      "precision": "bf16",
      "supported_hardware": null,
      "model_revision": null,
      "declared_planning_minimum_gb": 40,
      "minimum_runtime_version": "0.29.0",
      "extra_args": [],
      "tensor_parallel_by_hardware": null
    },
    {
      "variant": "fp8",
      "model_id": "Qwen/Qwen-Image-2.1",
      "precision": "fp8",
      "supported_hardware": null,
      "model_revision": null,
      "declared_planning_minimum_gb": 40,
      "minimum_runtime_version": "0.29.0",
      "extra_args": [
        "--diffusion-quantization-config",
        "{\"transformer\":{\"method\":\"fp8\",\"ignored_layers\":[\"img_mlp\"]}}"
      ],
      "tensor_parallel_by_hardware": null
    }
  ],
  "recipe_parameters": {
    "minimum_runtime_version": "0.29.0",
    "nightly_required": false,
    "model_context_limit_tokens": null,
    "compatible_strategies": [
      "single_node_tp"
    ],
    "hardware_claims": [
      {
        "profile": "gb300",
        "maintainer_status": "verified"
      }
    ],
    "recipe_updated_on": "2026-09-19",
    "effective_default_minimum_runtime_version": "0.29.0"
  },
  "measurement_scope": "deployment_reference",
  "notes": [
    "Recipe minimum engine version: 0.29.0.",
    "Default artifact: Qwen/Qwen-Image-2.1.",
    "Variant and hardware settings are source declarations; select the matching original profile."
  ],
  "limitations": [
    "Image throughput is not comparable with text-token throughput.",
    "Input length, output policy, concurrency and cache are workload-specific; no single benchmark is inferred from the recipe."
  ],
  "comparison_status": "not_comparable",
  "editorial_status": "source_derived_detailed_article",
  "public_benchmark_snapshot": false,
  "source": {
    "publisher": "vllm-project",
    "url": "https://github.com/vllm-project/recipes",
    "repository": "vllm-project/recipes",
    "platform": "github",
    "revision": "d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94",
    "document_path": "models/Qwen/Qwen-Image-2.1.yaml",
    "pinned_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml",
    "report_url": null,
    "document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb",
    "last_commit_at": "2026-10-17T09:22:45Z",
    "checked_on": "2026-10-17",
    "metadata_status": "checked"
  },
  "license": {
    "declared_spdx": "Apache-2.0",
    "scope": "Recipe repository only; each model and conversion has independent distribution terms."
  },
  "editorial": {
    "version": 1,
    "published_on": "2026-10-17",
    "modified_on": "2026-10-17",
    "byline": "Run AI Here editorial",
    "creation_method": "AI-assisted source reading and original editorial synthesis; no independent model execution.",
    "answer": "The pinned Qwen-Image-2.1 recipe defaults to Qwen/Qwen-Image-2.1 (bf16). Its effective default-variant minimum is vLLM 0.29.0. Select the exact variant, hardware override and topology before treating it as a launch plan. No deployment was run by this site.",
    "sections": [
      {
        "heading": "Which artifact and engine does this recipe select?",
        "paragraphs": [
          "The recipe identifies Qwen/Qwen-Image-2.1 as its model family entry and selects Qwen/Qwen-Image-2.1 by default. The default precision label is bf16; model-wide and variant-specific runtime requirements are kept separately below. The document revision fixes what the recipe said, while the weight revision and executed runtime revision remain separate fields. A model-family title alone cannot establish either artifact identity."
        ],
        "citations": [
          "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104"
        ]
      },
      {
        "heading": "What needs special attention for this model?",
        "paragraphs": [
          "This is image generation through vLLM-Omni, not a text decode benchmark. The YAML’s context-length zero is a not-applicable sentinel, not a zero-token model. The BF16 description reports a 34.0 GB peak on one GB300 at 1024×1024, 40 steps, CFG off and VAE tiling; its 40 GB planning minimum is a separate derived budget. Do not express image performance in language-model tokens per second."
        ],
        "citations": [
          "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L21"
        ]
      },
      {
        "heading": "How should the settings be applied?",
        "paragraphs": [
          "Choose one artifact variant and one hardware profile from the original recipe, then resolve its shared, variant, hardware, strategy and optional-feature settings together. The base arguments listed here are only one layer and are deliberately not presented as a complete runnable command. Check any nightly-image requirement and the model’s parsers before loading weights. A context declaration is a model limit, while batched-token and sequence settings control a serving workload."
        ],
        "citations": [
          "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L118"
        ]
      },
      {
        "heading": "What does the memory number mean?",
        "paragraphs": [
          "The GB figure is the recipe’s declared planning minimum for the selected variant. It is not a site measurement, a universal peak allocation or a promise of maximum context. KV cache, auxiliary/draft models, image encoders, temporary workspace and active requests still require memory. Keep GB and GiB distinct, and use the actual artifact size and runtime allocation for a machine-specific budget."
        ],
        "citations": [
          "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L108"
        ]
      },
      {
        "heading": "What is needed to reproduce a deployment?",
        "paragraphs": [
          "Save the model and conversion revisions, weight hashes, tokenizer/template, container or runtime digest, device count/topology and complete resolved launch. First check one short public request. For a subsequent measurement, fix input and output counts, concurrency, cache state, warmup, sampling, reasoning effort, repetitions and failures. The declarations on this page are source configuration facts; no throughput or quality outcome follows from them."
        ],
        "citations": [
          "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L125"
        ]
      }
    ],
    "facts": [
      {
        "name": "Architecture",
        "value": "dense",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L40",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Total parameters as counted by recipe",
        "value": "16B",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L41",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Active parameters as counted by recipe",
        "value": "16B",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L42",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Native context declaration (tokens)",
        "value": null,
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L43",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Model-wide minimum vLLM",
        "value": "0.29.0",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L27",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Effective default-variant minimum vLLM",
        "value": "0.29.0",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L27",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Default artifact",
        "value": "Qwen/Qwen-Image-2.1",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Default precision label",
        "value": "bf16",
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Default planning minimum (GB; recipe declaration)",
        "value": 40,
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L108",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Default variant hardware allowlist",
        "value": null,
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Shared base arguments (incomplete launch)",
        "value": [],
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Declared compatible strategies",
        "value": [
          "single_node_tp"
        ],
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Optional feature names",
        "value": [],
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      },
      {
        "name": "Features selected by default",
        "value": [],
        "classification": "recipe_declaration",
        "evidence_url": "https://github.com/vllm-project/recipes/blob/d5fc1f55cee70f4e1944f2dd4f7569cb8276ad94/models/Qwen/Qwen-Image-2.1.yaml#L104",
        "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
      }
    ],
    "reported_results": [],
    "source_document_sha256": "b7423875f68d7111765c3206e0fab9ec9c590b98f9d041c8f956339479fb23cb"
  }
}