Template-KleinBase4B-ControlNet

DiffSynth-Studio/Template-KleinBase4B-ControlNet

PublisherDiffSynth-Studio

Download access requirementsModelScope source

Templates-结构控制（FLUX.2-klein-base-4B）本模型是 DiffSynth-Studio 开源的 Diffusion Templates 系列模型之一。该模型为 ControlNet 控制模型，能够通过输入的参考图对生成图像的空间结构、物体轮廓与透视进行精准的条件引导。开源代码：DiffSynth-Studio

Image Generation

View all download instructions Mirror repository documentation and license ↗

Model details

模型介绍

中文整理

Templates-结构控制（FLUX.2-klein-base-4B）

本模型是 DiffSynth-Studio 开源的 Diffusion Templates 系列模型之一。该模型为 ControlNet 控制模型，能够通过输入的参考图对生成图像的空间结构、物体轮廓与透视进行精准的条件引导。

开源代码：DiffSynth-Studio

技术报告：arXiv

项目主页：GitHub

文档参考：English Version、中文版

在线体验：魔搭社区创空间

模型集：ModelScope、ModelScope 国际站、HuggingFace

数据集：ModelScope、ModelScope 国际站、HuggingFace

效果展示

Condition Prompt: A cat is sitting on a stone, bathed in bright sunshine. Prompt: A cat is sitting on a stone, surrounded by colorful magical particles.

Condition Prompt: A lovely fox wearing a casual green shirt, sitting in a cafe bar, smiling gently, peaceful anime aesthetic. Prompt: A cute 3D rendered anthropomorphic fox character wearing a bright green shirt, sitting in a cozy magical tavern, smiling happily.

Condition Prompt: A photorealistic glass crystal ball containing a tiny, dreamy scene of a castle, a large tree, and a girl, soft warm lighting, detailed texture. Prompt: A cute 3D Pixar style scene inside a crystal ball, featuring a girl standing by a large tree with a castle in the background.

推理代码

安装 DiffSynth-Studio

直接推理，需 40G 显存

开启惰性加载和显存管理，需 24G 显存

训练代码

安装 DiffSynth-Studio 后，使用以下脚本可开启训练，更多信息请参考 DiffSynth-Studio 文档。

优先采用原作者提供的中文模型卡片；仅有英文说明时由闲社AI翻译整理。重要参数、许可证和商用范围请以原文为准。

你将获得什么

完整仓库方式包含该固定版本中的权重、配置、分词器及说明文件；指定版本方式只下载所选文件或整组分片。多模态模型的投影文件、配置等依赖，请按作者说明配齐。

完整仓库可能包含多个权重格式，因此需要的磁盘空间可能大于单一格式的模型大小。下载文件不等于完成模型部署。

使用前须知

运行环境

运行模型需要的设备、工具与依赖，以原作者说明为准。

授权范围

是否允许商用、修改和分发，请查看模型许可证。

闲社提供资料与镜像下载方法，不代表已运行模型或完成安全审计。下载的代码应先检查，再执行。

Problem with the information or download?

Pinned version · Multiple download options

Template-KleinBase4B-ControlNet model download

Download the full repository or choose a version or file.

Download tools · More than GGUF

Use the Hugging Face download tool to obtain DiffSynth-Studio/Template-KleinBase4B-ControlNet. Download Safetensors, GGUF, ONNX, configuration and other repository files. Downloading does not mean the tool can run this model.

Pinned-version file information is being completed. Existing downloads remain available, or load the file manifest below.

Choose a mirror or official source, your operating system and download scope below, then copy the command. Install the download tool first if needed.

Pinned version: b9a1dbb6336c66924e18ace5c1bc1ceb597c2161. Downloads files only; does not start the model.

Choose a download source

Pinned ModelScope version: b9a1dbb6336c66924e18ace5c1bc1ceb597c2161. Version identifiers can differ across sites. The alternative source was provided after checking weights and runtime configuration; this is not proof of a successful model run.

A checked, pinned ModelScope source is available for this model. Use the ModelScope download tool.

Choose what to download

Need just one GGUF precision? Load the file manifest and choose a version. Direct file links do not require Python; the command below can download multiple shards together.

Quantization / file

This reads the pinned version's file manifest; no model weights are downloaded.

Choose your operating system

For command-line downloads, follow these steps to get the full repository or selected files. Direct file links do not need these steps.

Open a terminal window

Create and open a folder for the model. In the folder's address bar, enter powershell and press Enter.

If Python is not installed, get it from the official Python website. In the terminal, enter python --version; continue when a version number appears.

First time? Install the download tool

Copy this command, paste it into the terminal, press Enter and wait for installation to finish.

python -m pip install --upgrade huggingface_hub

Already installed? Continue to step 3.

Run the download command

Select the button below, paste into the same terminal and press Enter. The tool downloads all files included in the current command.

Copying does not start a download. Paste and run the command on your device.

Where are the downloaded files?

Open the folder you chose. Look for the models folder. When progress stops and the terminal returns to its prompt without errors, check that all files are present. 'Copied' does not mean 'downloaded'.

No response or an error?

python not found: Install Python and reopen the terminal. On Windows, follow the installer's instructions to enable command-line access.

hf not found: Confirm that step 2 succeeded, then reopen the terminal. If needed, add Python's Scripts folder to your user PATH. Do not repeatedly download scripts.

Network interrupted: Stay in the same folder and run the same command again. The tool checks existing files.

Permission or disk error: Choose a writable folder with enough free space. Do not disable system security protection.

View the full download command

modelscope download --model "DiffSynth-Studio/Template-KleinBase4B-ControlNet" --revision "b9a1dbb6336c66924e18ace5c1bc1ceb597c2161" --local_dir "./models/DiffSynth-Studio--Template-KleinBase4B-ControlNet--ms-b9a1dbb6336c"

Files transfer directly from the source you choose, not through Xianshe servers.

The version is pinned. Repeating the same command checks existing files. Change the source manually if it is slow or unavailable.

Public models do not require submitting keys to Xianshe. Restricted models still require the author's authorization. On Linux / macOS, use python3 instead of python when appropriate.