π€ ModelScope | π€ HuggingFace | π» GitHub | π Qwen-Image-2.1 Blog | 𫨠Discord | π¬ WeChat
## Introduction **Qwen-Image-2.1-Turbo** is an accelerated checkpoint of [Qwen-Image-2.1](https://huggingface.co/Qwen/Qwen-Image-2.1) for text-to-image generation and image editing with **8 denoising steps**. It uses the same 7B visual generation architecture and loads directly with `QwenImage21Pipeline` in Diffusers. The checkpoint includes its recommended sampling schedule, so it is ready to use without manually configuring the scheduler. Generation uses CFG=1 by default, and prefix KV caching reuses the text and reference-image context across denoising steps. For more details, see the [GitHub repo](https://github.com/QwenLM/Qwen-Image-2.1) and [Qwen-Image-2.1 blog](https://qwen.ai/blog?id=qwen-image-2.1). ## Quick Start ### Installation Install a CUDA-compatible PyTorch build, then install the latest Diffusers source and the following dependencies: ```bash pip install git+https://github.com/huggingface/diffusers.git pip install "transformers>=5.17.0" accelerate pillow ``` This checkpoint requires Diffusers with support for pipeline-configured sampling sigmas, added in [PR #14950](https://github.com/huggingface/diffusers/pull/14950). ### Text-to-Image Load the checkpoint from Hugging Face: ```python import torch from diffusers import QwenImage21Pipeline pipe = QwenImage21Pipeline.from_pretrained( "Qwen/Qwen-Image-2.1-Turbo", dtype=torch.bfloat16, ).to("cuda") prompt = "The image shows an open illustrated cookbook or recipe journal spread about sushi, rendered in a warm handmade watercolor style on cream, parchment-like paper with visible grain, soft beige aging, subtle stains, and faint ruled notebook lines. A narrow vertical fold divides the two pages at the center, with gentle shadows suggesting a physical open book. At the very top-left edge, a strip of torn blue washi-style tape with white wavy sea motifs overlaps the page border. Nearby, a small coral-orange fish sticker with dark outline, black dot eyes, fins, tail, and scales floats decoratively above the headline, surrounded by small blue outline bubbles and splash droplets. The left page is headed by the large handwritten title \"Sushi Roll\" in bold coral-red script, centered near the top and emphasized by a long wavy blue underline. A small orange starfish illustration with darker spots and black outline sits near the upper-right end of the title area, with additional blue bubbles scattered around the margins. Below the title, the ingredients are arranged like labeled illustrations in a loose grid. In the upper-left ingredient group, a wooden bowl filled with glossy white grains of sushi rice is drawn from a slightly elevated angle, with individual rice kernels shaded in pale cream and gray; its dark ink handwritten caption reads \"Sushi Rice\" and \"2 cups\". To its right, several overlapping rectangular dark green-black nori seaweed sheets with wrinkled matte texture are stacked diagonally; the label beneath reads \"Nori Sheets\" and \"4 sheets\". In the middle-left, a bright orange salmon fillet with white marbling lines lies horizontally on a pale shadow wash; the caption reads \"Fresh Salmon\" and \"200g\". In the middle-right, a whole cucumber with speckled dark-to-light green skin, small bumps, and a short stem stands upright; the label underneath reads \"Cucumber\" and \"1 whole\". In the lower-left-middle, a halved avocado with green flesh, darker peel, and a brown pit is shown front-facing; its caption reads \"Avocado\" and \"1 whole\". In the lower-right-middle, a shallow beige ceramic bowl holds tan sesame seeds in a granular mound; the text below reads \"Sesame Seeds\" and \"2 tbsp\". Along the bottom-left of the ingredients section, a small glass bottle of soy sauce with dark reddish-brown liquid, transparent reflections, and a cork stopper is tilted slightly; its caption reads \"Soy Sauce\" and \"50 ml\". Along the bottom-center/right, a metallic squeeze tube of wasabi is angled diagonally with beige-green paste emerging from the nozzle; the label reads \"Wasabi\" and \"1 tube\". Blue bubble outlines, small star doodles, and tiny blue brush marks decorate the blank spaces around these ingredients without forming any extra readable text. On the right page, the top-right corner has a torn strip of blue patterned washi tape with white wavy lines, placed partly over the page edge. Beneath it, the step-by-step recipe is laid out as a vertical flowchart made of rounded rectangular panels connected by small curved blue arrows pointing downward. Each panel has a thin hand-drawn colored outline, either muted blue or coral-pink, rounded corners, and a small numbered circular badge in blue outline at the left of the text area. The first panel near the top contains a small wooden bowl of rice being mixed with a pale wooden rice paddle; its blue circled number reads \"1\", the heading reads \"Step 1\" and \"Cook Seasoned Rice\", and the instruction text reads \"Mix rice vinegar,\" followed by \"sugar, and salt\" and \"into warm rice\". A dotted curved arrow leads downward to the second panel, which includes a pair of human hands with light peach skin tones placing a dark nori sheet onto a bamboo rolling mat; the hands are shown in close-up with slender fingers, neatly manicured pale nails, and a calm working posture. The second stepβs blue circled number reads \"2\", the heading reads \"Step 2\" and \"Lay Nori on Mat\", and the instruction reads \"Place shiny side down\" and \"on the bamboo mat\". The third panel shows close-up hands spreading sticky white rice evenly across a dark nori surface on a bamboo mat, with the rice forming a rounded layer and leaving space near the far edge; its number reads \"3\", the heading reads \"Step 3\" and \"Step 3 Spread Rice Evenly\", and the instruction reads \"Leave a 1-inch border\" and \"at the top edge\". The fourth panel shows strips of filling arranged in parallel inside an open roll: orange salmon, green cucumber, and pale avocado sit on rice atop dark nori on the bamboo mat; the hands are partially visible at the sides adjusting the fillings. Its number reads \"4\", the heading reads \"Step 4\" and \"Place Fillings\", and the instruction reads \"Add salmon, cucumber,\" then \"and avocado strips\" and \"in the center\". The fifth panel depicts the rolled sushi being tightly formed with a bamboo mat wrapped around it while hands press gently from the sides; its number reads \"5\", the heading reads \"Step 5\" and \"Roll Tightly\", and the instruction reads \"Lift the mat and roll\" and \"forward, pressing gently\". The sixth panel shows a chefβs knife slicing cooked sushi rolls on a cutting board, with one completed outside-in roll showing orange salmon, cucumber, avocado, white rice, and dark seaweed layers; the adult hand holding the knife has light skin and trimmed nails, while the blade is long, silver-gray, and angled diagonally across the panel. Its number reads \"6\", the heading reads \"Step 6\" and \"Cut with Wet Knife\", and the instruction reads \"Wipe blade with a\" and \"wet cloth between cuts\". The seventh panel at the lower-right displays the finished plate of sushi rolls: several cut rolls topped with roe, sesame seeds, salmon, and garnishes sit on a pale dish, with folded pickled ginger slices and shredded green garnish nearby. Its number reads \"7\", the heading reads \"Step 7\" and \"Plate Beautifully\", and the instruction reads \"Arrange on a dish\" and \"with pickled ginger\". A small coral-orange fish sticker appears near the lower-left side of the right page, echoing the fish sticker on the left page. Near the bottom-right of the right page, a large red square seal-style stamp with rough ink texture contains the Japanese characters \"ζδ½γ\", reinforcing the handmade theme. Throughout both pages, the typography combines casual handwritten dark gray captions with coral-red calligraphic titles and headings, while the borders, arrows, bubbles, tape, starfish, and fish stickers use a coordinated palette of deep ocean blue, cream, wood brown, green, orange, and coral. The overall composition is a friendly instructional cooking diagram designed like a scrapbook page, balancing detailed food illustrations with decorative seaside-themed stationery elements." image = pipe( prompt=prompt, width=2048, height=2048, use_kv_cache=True, generator=torch.Generator("cpu").manual_seed(20261008), ).images[0] image.save("t2i.png") ``` The pipeline automatically uses the checkpoint's saved **8-step schedule**. The examples use the **2048 resolution level** for both generation and editing; square outputs are 2048 Γ 2048. ### Image Editing Reuse the pipeline above to turn a yacht sketch into a photorealistic image: ```python from diffusers.utils import load_image input_image = load_image( 'https://huggingface.co/Qwen/Qwen-Image-2.1-Turbo/resolve/main/assets/turbo-boat-input.png' ).convert("RGBA") edit_prompt = "Create a photorealistic photograph of the motor yacht from the input sketch, sailing on open sea, captured in full side profile with the camera at water level. Build the vessel with the structure shown in the input sketch: a long low hull; one tall mast stepped forward with a small cross-tree platform near its top; a wheelhouse superstructure with an open bridge wing just behind the mast; a midships deckhouse carrying a row of four rectangular windows with a lifeboat stowed on its roof; a rectangular funnel behind that deckhouse; an aft deckhouse with a row of three rectangular windows and a second lifeboat above it; thin railings along every deck edge; the hull side pierced by one small square window at the bow, an upper line of five round portholes on the raised forward section, and a lower line of nine round portholes along the main hull. Paint the hull black, the superstructures and the mast white, and the funnel yellow. Set the yacht broadside on a calm deep-blue sea with a low gentle swell and a thin white wake trailing from the bow, the straight horizon crossing behind the funnel top, under a clear sky with soft scattered clouds; sunlight from the front left lights the white superstructures and leaves a bright reflection path on the water beside the hull with a soft contact shadow along the waterline; the entire vessel fits inside the frame with open water in the foreground and sky above." image = pipe( prompt=edit_prompt, image=input_image, width=2048, height=2048, use_kv_cache=True, generator=torch.Generator("cpu").manual_seed(20261009), ).images[0] image.save("edit.png") ``` ### Sampling The recommended 8-step sampling schedule is saved with the checkpoint and loaded automatically. Setting `num_inference_steps` alone does not override it. For experiments, an explicit call-time `sigmas` argument overrides the saved schedule; other schedules have not been evaluated for this checkpoint. ### Supported Aspect Ratios Use the same resolution presets as Qwen-Image-2.1: ```python aspect_ratios = { "1:1": (2048, 2048), "4:3": (2400, 1792), "3:4": (1792, 2400), "3:2": (2528, 1696), "2:3": (1696, 2528), "16:9": (2752, 1536), "9:16": (1536, 2752), } ``` ## Showcase Examples from the 8-step outputs in our Turbo showcase. Each category features one example. ### Portrait Photography
